- 移动/网站应用 OpenAPI SDK 总览
- OpenAPI 列表
- 状态码排查工具
- 用户授权
- 用户管理
- 视频管理
- 互动管理
- 搜索管理
- 数据开放服务
- 企业号开放能力(内测结束暂不开放)
- 生活服务开放能力
- 工具能力
- 服务市场开放能力
- 小程序推广计划
- 联合授权
获取用户唯一标识
更新时间 2024-08-20 08:24:22
收藏
我的收藏接口说明
本能力支持开发者在「经认证属于同一主体的多个应用间」对抖音用户进行唯一性识别。
使用限制
无
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/api/douyin/v1/auth/get_related_id/ |
HTTP Method | POST |
Scope | open.account.data |
权限要求 | 无 |
请求头
名称 | 字段类型 | 是否必填 | 示例 | 描述 |
---|---|---|---|---|
access-token | String | 是 | clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ | |
content-type | String | 是 | application/json | 固定值"application/json" |
请求参数
Body
名称 | 字段类型 | 是否必填 | 示例 | 描述 |
---|---|---|---|---|
open_id | String | 是 | ba253642-0590-40bc-9bdf-9a1334b94059 | 用户open_id,通过/oauth/access_token/获取,用户在应用下的唯一标志 |
请求示例
curl --location --request POST '/api/douyin/v1/auth/get_related_id/' \
--header 'content-type: application/json' \
--header 'access-token: clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1******' \
--data '{"open_id":"Cv4PoJXaTPn63rNu"}'
响应参数
Body
名称 | 字段类型 | 是否必填 | 示例 | 描述 |
---|---|---|---|---|
data | Struct | 是 | ||
err_msg | String | 是 | access_token无效 | 错误描述 |
err_no | Int32 | 是 | 28001003 | 错误码 |
log_id | String | 是 | 202405291440576E078D8757B9 | 日志id |
响应示例
正常响应示例
{
"log_id": "202405291440576E078D8757B9",
"data": {
"allied_id": "ZsNCZC1dUR"
},
"err_no": 0,
"err_msg": ""
}
异常响应示例
{
"log_id": "202405291440576E078D8757B9",
"data": {},
"err_no": 28001003,
"err_msg": "access_token无效"
}
错误码
http状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 28001005 | 系统内部错误,请重试 | 请求重试,若依然无解请向平台提交反馈 |
200 | 28001003 | access_token无效 | 重新请求生成access_token |
200 | 28001008 | access_token过期,请刷新或重新授权 | 重新请求生成access_token |
200 | 28001006 | 网络调用错误,请重试 | 重试即可 |
200 | 28001007 | 参数不合法 | 根据错误信息检查请求参数是否填写正常 |
该文档是否有帮助?
点击纠错