通用参数
开发者请求公共参数
所有 OpenAPI 接口均需要设置这几个字段,API 文档中将不再重复解释。
字段名 | 类型 | 位置 | 是否必填 | 字段说明 |
Content-Type | string | Header | 是 | 固定值:application/json |
access-token | string | Header | 是 |
平台请求开发者公共参数
注意:这里是平台调用开发者系统的时候请求头中携带的内容
字段名 | 类型 | 位置 | 是否必填 | 字段说明 | 取值范例 |
Content-Type | string | Header | 是 | 固定值:application/json | application/json |
Byte-Identifyname | string | Header | 是 | 开发者回调路径,不包含域名 | /order/create_order_callback_url |
Byte-Logid | string | Header | 是 | 日志id,请参考-签名算法 | 20230504163800ABA7347CE4F5 |
Byte-Nonce-Str | string | Header | 是 | 随机字符串,请参考-签名算法 | Bhw73xUDN91kova0f3KkVegl0WPpz9BZ |
Byte-Signature | string | Header | 是 | 请求包签名,请参考-签名算法 | mx0xMwumjHScvSjFHjKTvSlBJu1G2aw== |
Byte-Timestamp | string | Header | 是 | 请求时间戳,精度:秒,请参考-签名算法 | 1683189481 |
签名算法
- •外部开发者请求抖音开放平台交易系统接口
如上面的请求公共参数说明,抖音开放平台交易系统的 OpenAPI 接口均使用 access-token 参数鉴权,不需 要添加额外的签名参数。
- •抖音开放平台交易系统请求外部开发者的接口
当抖音开放平台交易系统需要回调开发者接口时,比如预下单回调、支付完成通知等场景,抖音开放平台交易系统会在 header 中添加签名参数,开发者需要对签名参数进行校验。
响应公共参数
extra 信息
名称 | 类型 | 是否必填 | 描述 | 示例值 |
error_code | int | 是 | 错误码,0为成功 | 0 |
description | string | 是 | 错误码描述 | success |
sub_error_code | int | 是 | 子错误码 | 0 |
sub_description | string | 是 | 子错误码描述 | success |
logid | string | 是 | 请求id | 2022092115392201020812109511046 |
now | int | 是 | 时间戳 | 1663815603 |
关于 xxx_entry_schema 的前置说明
在接入的 open-api 中,有些 open-api 会有一个叫 xxx_entry_schema 的参数,这个参数是小程序某个页面的跳转地址,比如在下单场景中平台调用开发者预下单接口后会要求开发者返回一个叫 order_entry_schema 的字段,因为小程序的订单会展示的抖音 app 的订单中心,用户从抖音订单中心进入小程序订单详情页的时候需要一个跳转地址,这个地址就是开发者返回的 order_entry_schema 字段。请注意凡是使用 path+params 字段的方式传递小程序 xx 详情页跳转地址的位置,path 和 params 都必须严格符合下列规范,后续相关文档字段说明中将不再在各处对此规范约束进行说明:
名称 | 类型 | 是否必传 | 描述 | 正确示例 | 错误示例 |
path | string | 是 | 小程序xxx详情页跳转路径,没有前导的“/”,路径后不可携带query参数,路径中不可携带『?: & *』等特殊字符,路径只可以是『英文字符、数字、_、/ 』等组成,长度<=512byte | page/path/index | page/path/index?id=1234 page/path:hello/index |
params | string | 否 | xx情页路径参数,自定义的json结构,序列化成字符串存入该字段,平台不限制,但是写入的内容需要能够保证生成访问xx详情的schema能正确跳转到小程序内部的xx详情页,长度须<=512byte,params内key不可重复。 | {"id":1234,"name":hello} | {"id":1234,"id":2334,"name":hello} |