抖音开放平台Logo
开发者文档
生活服务商家应用
“/”唤起搜索
控制台
  • 生活服务开放平台介绍
  • 自研商家入驻指南
  • 基础配置
  • 验收准备
  • 测试验收
  • 应用上线
  • 排查工具
  • 联系技术支持
  • 常见问题

    • 整体流程

    说明
    本流程仅针对自研商家接入开放能力进行介绍，商家如何入驻抖音来客以及在抖音来客上经营可参考：抖音来客使用手册。
    ​
    ​

    入驻抖音来客

      •移动端操作：在各大应用商店下载「抖音来客」App，完成入驻。
      •PC 端操作：登录抖音来客注册账号，完成入驻。

    绑定开发者身份

    没有抖音开放平台账号

      1.商家登录抖音来客。
      2.在左侧导航栏选择店铺管理 > 服务应用授权，在服务应用授权页面点击商家自研服务，在商家自研服务页签点击入驻开放平台。
      3.在入驻开放平台面板填写相关信息，点击保存并提交，等待审核成功 。
      4.返回服务应用授权页面，在操作列点击前往开发者平台，跳转至开发者平台。

    已拥有抖音开放平台账号

      1.商家登录抖音来客。
      2.在左侧导航栏选择店铺管理 > 服务应用授权，在服务应用授权页面点击商家自研服务，在商家自研服务页签点击绑定开发者。
      3.在绑定开发者对话框中通过手机号/邮箱绑定开发者。
      ◦通过手机号绑定
      ◦通过邮箱绑定
      4.绑定成功后，返回服务应用授权页面，在操作列点击前往开发者平台，跳转至开发者平台。
    ​

    创建生活服务商家应用

    第一步：创建生活服务商家应用

    登录抖音开放平台-开发者平台，进入控制台，创建生活服务商家应用，并填写应用信息。

    第二步：等待审核完成

    审核时效为 1 个工作日。

    第三步：查看应用详情

    创建成功后即可进入应用详情页，查看对接所需的应用信息：
      •APPID = ClientKey
      •AppSecret = ClientSecret

    解决方案开通与自助化接入

    按照自助化接入：解决方案开通->基础配置->验收准备->测试验收->应用上线逐步完成所有配置和开发工作。
    详见：自助化接入
    ​

    接口调用规则和注意事项

    若您在开发中遇到任何技术问题，请通过页面右下角「开发者助手」提交技术工单，或联系您的BD获取更多技术支持。

    接口调用注意事项：域名路径

      1.接口访问域名统一为https://open.douyin.com，务必使用 HTTPS 请求。
      2.接口路径详见各接口，注意路径均以/结尾，/不可省略。
    公共请求头
    所有接口都需要包含公共请求头，后续接口文档中不再单独说明。
    参数
    描述
    必须
    content-type
    application/json
    是
    当服务商调用抖音接口时，需传递该请求头。
    参数
    描述
    必须
    access-token
    根据生成 client_token 获取的 token
    是
    log_id
    抖音侧的问题排查标识
    是
    调用所有接口请求头中均需传 access-token。access-token 的值需调用 /oauth/client_token/ 生成，取响应体 data.access_token，详情请参见生成 client_token。
    调用 POST 接口，请求头需传 content-type: application/json。

    服务商侧签名规则

    详细签名规则参考 SPI 签名机制说明。
    url 中的参数：
    参数名称
    参数类型
    参数描述
    必需
    client_key
    string
    服务商的 client_key
    是
    timestamp
    string
    时间戳，单位毫秒
    是
    sign
    string
    生成签名时无视该字段
    否
    header 中的 sign 参数：
    当抖音调用服务商接口时，以下内容会通过 header 传递。
    参数名称
    参数类型
    参数描述
    必需
    x-life-clientkey
    string
    服务商的 client_key
    是
    仅作为应用标识使用
    x-life-sign
    string
    新签名
    是
    验签用
    sign 的生成方式如下：
      1.以三方服务商的 client_secret 开头；
      2.将除 sign 之外的 URL 参数以 key=value 的形式按 key 的字典升序排列；
        若为 POST 请求，还需要加上 HTTP 的 BODY，key 固定为 http_body（http_body 的内容不参与排序，加到最后）。
      3.所有的这些项以字符 &串联起来即为待签名内容 str1。
    发码接口的示例如下（假设 client_secret 为 yyyyyy）：
    str1的内容是 yyyyyy&client_key=xxxxxx&timestamp=1624293280123&http_body=zzzzzz。
    然后将待签名内容 str1 计算 SHA-256 哈希值，得到的结果即为 sign。
    说明
    ​
    ​

    注意事项

    请重点关注以下几项
      1.验券接口返回的验券结果 result 字段必须进行业务匹配检查。
        说明：当 result 返回非 0 时，表示业务侧提示而非技术异常，需进行相应的业务处理。
      2.抖音侧接口返回失败，三方系统需有重试机制。
        针对服务抖动造成的接口异常，一般重试即可解决。
      3.建议三方系统做核销结果判断时，需预校验抖音返回结果，避免双方订单信息状态不一致。
      4.信息同步接口必接，避免抖音客服强制退款，服务商无感知。