接口说明

该接口可获取用于备案人证核验的链接。

小程序负责人需先完成人证核验才可继续备案。
开发者可使用人证核验链接作为二维码的内容生成二维码，让小程序负责人抖音扫码完成核验。
人证核验链接有效期为 2 个小时，小程序负责人需在 2 小时内完成核验；核验的结果 72 个小时有效。

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/apps/v1/icp_record/get_facial_recognition_url/
HTTP Method	GET
Scope	ma.icp_record.facial_recognition
权限要求	授权小程序授予基本信息设置权限集

请求参数

请求头

access-token必填String

示例：isvact.0801121846735352506a356a6

调用https://open.douyin.com/api/tpapp/v2/auth/get_auth_token/生成的token

content-type必填String

示例：application/json

固定值"application/json"

Query

province_code必填String

省份编码，通过查询区域信息接口获取

需要提交备案的省份编码保持一致

请求示例
curl --location 'https://open.douyin.com/api/apps/v1/icp_record/get_facial_recognition_url?province_code=310000' \
--header 'access-token: isvact.xxxx'

响应参数

Body展开全部子属性

err_msg必填String

错误描述

err_no必填Int32

错误码

log_id必填String

标识请求的唯一id

dataStruct

展开子属性

响应示例
正常响应示例异常响应示例
{
  "err_no": 0,
  "log_id": "2023120718400603FC7DFC64EFC63EE90F",
  "data": {
    "facial_recognition_token": "xxxx",
    "facial_recognition_url": "https://xxxxxx"
  },
  "err_msg": ""
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	9999	系统错误
200	28001008	access_token过期

开发者文档

获取人证核验链接

接口说明

基本信息

请求参数

响应参数

错误码

获取人证核验链接在线调试

接口说明

基本信息

请求参数

响应参数

错误码

获取人证核验链接