抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • 接入前准备
  • API接口
  • 能力
  • 历史版本文档(不推荐)
  • 景区团购(在线预约)
  • 设置分佣比例
  • 代运营佣金
  • 建立代运营合作关系
  • 代运营合作
  • 景区日历票
  • 景区行业团购|在线预约解决方案
  • 餐饮团购
  • 线索经营
  • 预置码
  • 批量增加券码
  • 同步订单信息
  • 查询券码对应订单信息
  • 通知增加券码
  • 更新预售券的预约库存日历
  • 酒店日历房接口
  • 三方码
  • 酒店新预售券接口
  • 酒旅
  • 通用能力
  • 接入前准备
  • 用于预置码同步订单信息。

    使用限制

    无

    接口说明

    1、当用户下单购买后,抖音将预置券码发放给用户,然后会将订单信息推送给商家/服务商。
    2、若推送失败重试 3 次,策略 5s 、25s、60s。
    3、预置解密办法见文档最后部分解密方法和解密代码示例。

    基本信息

    HTTP URL
    地址由服务商提供
    HTTP Method
    POST
    申请权限
    三方码能力
    权限要求
      •需要申请权限 ,路径:抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案
      •需要url配置,路径:联系抖音对接技术人员,做配置
      •需要商家授权,路径:抖音来客>店铺管理>服务应用授权

    签名规则

    签名规则参考查看 这个地址 的说明

    请求参数

    Body 参数

    参数名称
    类型
    参数描述
    必须
    order_id
    string
    订单ID
    是
    sku_id
    string
    商品ID
    是
    third_sku_id
    string
    三方商品ID
    否
    amount
    struct
    金额信息
    是
    .original_amount
    int
    原始金额,单位分
    是
    .pay_amount
    int
    实付金额,单位分
    是
    .merchant_ticket_amount
    int
    商家营销金额,单位分
    否
    .platform_ticket_amount
    int
    平台营销金额,单位分
    否
    .payment_discount_amount
    int
    支付优惠金额,单位分
    否
    .fee_amount
    int
    支付手续费,单位分
    否
    tourists
    list(object)
    出行人信息
    否
    .name
    string
    姓名
    否
    .phone
    string
    联系电话
    否
    .id_card
    string
    身份证号码
    否
    codes
    list(string)
    预置码
    是
    create_time
    int64
    券码发放时间(秒时间戳)
    是

    请求示例

    { "order_id": "123", "sku_id": "456", "third_sku_id": "a111", "count": 2, "amount": { "original_amount": 110, "pay_amount": 50, "platform_ticket_amount": 5, "merchant_ticket_amount": 5, "fee_amount": 0, "payment_discount_amount": 50 }, "tourists": [ { "name": "张三", "phone": "bYlB3dcl8e8rDyAdD7yYCA==", // 解密后:1333xxxxxxxx "id_card": "bYlB3dcl8e8rDyAdD7yYCA==" // 解密后:341282xxxxxxx }, { "name": "李四", "phone": "bYlB3dcl8e8rDyAdD7yYCA==", "id_card": "bYlB3dcl8e8rDyAdD7yYCA==" } ], "codes": ["1xxx", "2xxx"], "create_time": 1658914610 }

    响应字段

    字段
    类型
    描述
    data
    object
    ​
    .err_code
    int
    接口错误码,0表示成功 ,-1表示失败(最多重试3次)
    .description
    string
    接口错误描述,失败时带上错误信息

    响应示例

    { "data": { "err_code": 0, "description": "" } }

    解密方法

      1.根据ClientKey找到ClientSecret,将ClientSecret向左右使用字符补齐32位/裁剪至32位,补齐:补位字符:#, 先补左侧再补右侧再补左侧······直到补满32位。裁剪:先裁剪左侧再裁右侧再裁左侧······直到剩余32位。(正常不需要补齐,secret默认为32位,此举是为了以防万一)
      2.将ClientSecret作为Key, 右侧16位为向量IV
      3.将密文进行base64解码。
      4.使用AES-256-CBC模式解密解码后的密文,对齐使用PKCS5Padding方式

    解密用代码示例

    Golang

    package utils import ( "bytes" "crypto/aes" "crypto/cipher" "encoding/base64" ) // AesDecrypt 解密函数 // encryptedStr:base64后的密文 // secret:appid/client_key对应的client_secret // return: []byte 明文 func AesDecrypt(encryptedStr string, secret string) ([]byte, error) { // 加密字符串进行base64解码 decodeBytes, err := base64.StdEncoding.DecodeString(encryptedStr) if err != nil { return nil, err } key, iv := parseSecret(secret) block, err := aes.NewCipher(key) if err != nil { return nil, err } blockSize := block.BlockSize() blockMode := cipher.NewCBCDecrypter(block, iv[:blockSize]) origData := make([]byte, len(decodeBytes)) blockMode.CryptBlocks(origData, decodeBytes) origData = PKCS5UnPadding(origData) return origData, nil } // parseSecret 将secret解析为key和iv func parseSecret(secret string) ([]byte, []byte) { // secret对齐为32位 secret = cutSecret(secret) secret = fillSecret(secret) key, iv := secret, secret[16:] return []byte(key), []byte(iv) } func fillSecret(secret string) string { if len(secret) >= 32 { return secret } rightCnt := (32 - len(secret)) / 2 leftCnt := 32 - len(secret) - rightCnt var byt bytes.Buffer byt.Write(bytes.Repeat([]byte("#"), leftCnt)) byt.WriteString(secret) byt.Write(bytes.Repeat([]byte("#"), rightCnt)) return byt.String() } func cutSecret(secret string) string { if len(secret) <= 32 { return secret } rightCnt := (len(secret) - 32) / 2 leftCnt := len(secret) - 32 - rightCnt return secret[leftCnt: 32+leftCnt] } func PKCS5UnPadding(origData []byte) []byte { length := len(origData) unpadding := int(origData[length-1]) return origData[:(length - unpadding)] }

    Java

    package com.douyin.open.goodlife; import javax.crypto.Cipher; import javax.crypto.spec.IvParameterSpec; import javax.crypto.spec.SecretKeySpec; import java.util.Base64; public class SignUtil { /* * appid/client_key对应的client_secret TODO 这里换成服务商的appsecret */ private static final String secret = "12345678901234566543210987654321"; private static final String key; private static final String iv; static { key = parseSecret(secret); iv = secret.substring(16); } /** * @Description AES解密 * @param data base64后的密文 * @return 明文 */ public static String decryptAES(String data) throws Exception { try { byte[] encrypted1 = decode(data);//先用base64解密 Cipher cipher = Cipher.getInstance("AES/CBC/PKCS5Padding"); SecretKeySpec keyspec = new SecretKeySpec(key.getBytes(), "AES"); IvParameterSpec ivspec = new IvParameterSpec(iv.getBytes()); cipher.init(Cipher.DECRYPT_MODE, keyspec, ivspec); byte[] original = cipher.doFinal(encrypted1); String originalString = new String(original); return originalString.trim(); } catch (Exception e) { e.printStackTrace(); return null; } } /** * base64编码 */ public static String encode(byte[] byteArray) { return new String(Base64.getEncoder().encode(byteArray)); } /** * base64解码 */ public static byte[] decode(String base64EncodedString) { return Base64.getDecoder().decode(base64EncodedString); } private static String parseSecret(String secret) { secret = fillSecret(secret); secret = cutSecret(secret); return secret; } private static String cutSecret(String secret) { if (secret.length() <= 32) { return secret; } int rightCnt = (secret.length() - 32) / 2; int leftCnt = secret.length() - 32 - rightCnt; return secret.substring(leftCnt, 32 + leftCnt); } private static String fillSecret(String secret) { if (secret.length() >= 32) { return secret; } int rightCnt = (32 - secret.length()) / 2; int leftCnt = 32 - secret.length() - rightCnt; StringBuilder sb = new StringBuilder(""); for (int i = 0; i < leftCnt; i++) { sb.append('#'); } sb.append(secret); for (int i = 0; i < rightCnt; i++) { sb.append('#'); } return sb.toString(); } }
    ​