获取用户公开信息__抖音开放平台

注意事项

•

若需要获取用户手机号，需要用户额外授权 mobile_alert 权限，本接口会额外返回 encrypt_mobile 字段，详见获取用户手机号。

•

为加强用户隐私保护，抖音支持用户选择虚拟头像和昵称，若获取到的昵称头像为以下数据，则表明用户选择了虚拟身份。

序号	昵称	头像地址
1	蛋蛋	https://p26-passport.byteacctimg.com/img/motor-img/4421dd562bd484463de19de1bd5ce890~noop.jpg
2	梨梨	https://p26-passport.byteacctimg.com/img/motor-img/a43822fd5527b4ed2f30328a772f6b62~noop.jpg
3	熊熊	https://p26-passport.byteacctimg.com/img/motor-img/f01ea16499ec70084a0765d80320da9e~noop.jpg
4	檬檬	https://p26-passport.byteacctimg.com/img/motor-img/506803da2e57db427918b5a7c88c1993~noop.jpg
5	石石	https://p26-passport.byteacctimg.com/img/user-avatar/307c386c32c59aa8ab64b603cdad9502~120x256.image
6	花花	https://p26-passport.byteacctimg.com/img/user-avatar/eef08713c65ba2e78578420050e3c359~120x256.image

•

e_account_role(帐号类型)字段特殊说明，文档中响应参数无此字段说明，但实际接口会返回，含义如下:

◦

EAccountM - 普通企业号

◦

EAccountS - 认证企业号

◦

EAccountK - 品牌企业号

接口说明

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

基本信息

名称	描述
HTTP URL	https://open.douyin.com/oauth/userinfo/
HTTP Method	POST
Scope	user_info
权限要求	需要申请权限。路径：抖音开放平台控制台 > 应用详情 > 能力管理 > 用户权限 > 授权登录与用户基础信息需要用户授权

请求头

名称	字段类型	是否必填	示例	描述
content-type	String	是	application/x-www-form-urlencoded	固定值 "application/x-www-form-urlencoded"

请求参数

Body

名称	字段类型	是否必填	示例	描述
access_token	String	是	act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ	调用https://open.douyin.com/oauth/access_token/生成的token
open_id	String	是	ba253642-0590-40bc-9bdf-9a1334******	通过 /oauth/access_token/ 获取，用户唯一标识

请求示例

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	否

响应示例

正常响应示例

{
  "data": {
    "avatar": "https://example.com/x.jpeg",
    "avatar_larger": "https://example.com/x.jpeg",
    "client_key": "ExampleClientKey",
    "e_account_role": "",
    "error_code": 0,
    "log_id": "202212011600080101351682282501F9E7",
    "nickname": "TestAccount",
    "open_id": "0da22181-d833-447f-995f-1beefe******",
    "union_id": "1ad4e099-4a0c-47d1-a410-bffb4f******"
  },
  "message": "success"
}

异常响应示例

{
  "data": {
    "description": "Parameter error",
    "error_code": 2100005
  },
  "extra": {
    "logid": "2020070614111601022506808001045D59",
    "now": 1594015876138
  }
}

错误码

http状态码	错误码	错误码描述	排查建议
400	41050	no user authority error	操作的用户需在通讯录权限范围中。
400	40001	param error	参数错误。
200	28001005	系统内部错误，请重试	请求重试，若依然无解请向平台提交反馈
200	28001003	access_token无效	重新请求生成access_token
200	28001008	access_token过期,请刷新或重新授权	重新请求生成access_token
200	28001016	当前应用已被封禁或下线	clientKey被封禁或者下线
200	28001006	网络调用错误，请重试	重试即可
200	28001014	应用未授权任何能力	确认应用是否授权能力
200	28001018	应用未获得该能力	开通相关能力
200	28003017	quota已用完	联系平台处理
200	28001019	应用该能力已被封禁	该能力被封禁，联系平台处理
200	28001007	参数不合法	根据错误信息检查请求参数是否填写正常

获取用户公开信息在线调试

​注意事项​

接口说明

基本信息

请求头

请求参数

Body

请求示例

响应参数

Body

响应示例

正常响应示例

异常响应示例

错误码

获取用户公开信息

注意事项