获取用户唯一标识__抖音开放平台

接口说明

本能力支持开发者在「经认证属于同一主体的多个应用间」对抖音用户进行唯一性识别。

使用限制

无

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/apps/v1/auth/get_related_id/
HTTP Method	POST
Scope	open.account.data
权限要求	无

请求头

名称	字段类型	是否必填	示例	描述
access-token	String	是	clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ	调用https://open.douyin.com/oauth/client_token/生成的token
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/apps/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	参数不合法	根据错误信息检查请求参数是否填写正常

获取用户唯一标识在线调试

接口说明

使用限制

基本信息

请求头

请求参数

Body

请求示例

响应参数

Body

响应示例

正常响应示例

异常响应示例

错误码

获取用户唯一标识