抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

获取用户公开信息

收藏
我的收藏

接口说明

该接口获取用户的抖音公开信息,包含昵称和头像,适用于抖音、抖音极速版。

基本信息

名称描述
HTTP URL
https://open.douyin.com/oauth/userinfo/
HTTP Method
POST
Scope
user_info
权限要求
获取用户基本信息

请求参数

请求头
content-type必填String
示例:application/json
固定值"application/json"
Body
access_token必填String
示例:act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
open_id必填String
示例:ba253642-0590-40bc-9bdf-9a1334******

用户唯一标识

请求示例
curl --location --request POST 'https://open.douyin.com/oauth/userinfo/' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'open_id=ba253642-0590-40bc-9bdf-9a1334******' \ --data-urlencode 'access_token=act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka2******'

响应参数

Body展开全部子属性
data必填Struct
展开子属性
err_msg必填String

错误描述

err_no必填Int32
示例:0

错误码

extra必填Struct
展开子属性
log_id必填String
示例:2025032716200991A1xxxxx30A01C4DF

日志标识ID

响应示例
正常响应示例异常响应示例
{ "err_msg": "", "log_id": "2025032716200991A1xxxxx30A01C4DF", "data": { "open_id": "qYm3LVbtDQ", "nickname": "李伟", "description": "", "e_account_role": "", "error_code": "0", "avatar": "https://xxx.com/xxx.jpeg", "client_key": "XQSXAWkY9f", "log_id": "2025032716200991A181xxxxx0A01C4DF", "union_id": "eVBXUMlnek" }, "err_no": 0 }
切换单列布局

错误码

HTTP 状态码错误码错误码描述排查建议
20028001005
系统内部错误,请重试
请求重试,若依然无解请向平台提交反馈
20028001003
access_token无效
重新请求生成access_token
20028001008
access_token过期,请刷新或重新授权
重新请求生成access_token
20028001016
当前应用已被封禁或下线
clientKey被封禁或者下线
20028001006
网络调用错误,请重试
重试即可
20028001014
应用未授权任何能力
确认应用是否授权能力
20028001018
应用未获得该能力
开通相关能力
20028003017
quota已用完
联系平台处理
20028001019
应用该能力已被封禁
该能力被封禁,联系平台处理
20028001007
参数不合法
根据错误信息检查请求参数是否填写正常