抖音开放平台Logo
控制台

挂载权限校验

收藏
我的收藏

接口说明

该接口用于校验小程序的挂载权限。

基本信息

名称描述
HTTP URL
https://open.douyin.com/api/apps/v1/devtool/get_mount_legal/
HTTP Method
GET
Scope
ma.mount.legal
权限要求
  • 需要申请权限。开发者需要至控制台-小程序页面下，进入“能力-挂载-短视频挂载”，申请“短视频挂载权限判断”能力。

请求头

名称字段类型是否必填示例描述
access-tokenString是clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
调用https://open.douyin.com/oauth/client_token/生成的token
content-typeString是application/json
固定值"application/json"

请求参数

Query

名称字段类型是否必填示例描述
micapp_idString是tt5daf2b12c2857910
输入小程序的micapp_id

请求示例

curl --location --request GET 'https://open.douyin.com/api/apps/v1/devtool/get_mount_legal/?micapp_id=tt5daf2b12c2857910' \
--header 'access-token: clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ' \

响应参数

Body

名称字段类型是否必填示例描述
err_msgString是"access_token无效"
错误描述
err_noInt32是28001003
错误码
log_idString是"202405291440576E078D8757B9"
日志id

响应示例

正常响应示例

{
  "err_no": 0,
  "err_msg": "",
  "log_id": "20230213140437EEEDFAB3025AEA105C06",
  "data": {
    "extra": {
      "sub_description": "",
      "logid": "20230213140437EEEDFAB3025AEA105C06",
      "now": 1597213176393,
      "error_code": 0,
      "description": "",
      "sub_error_code": 0
    },
    "data": {
      "error_code": 0,
      "description": "",
      "is_legal": false
    }
  }
}

异常响应示例

{
  "err_no": 0,
  "err_msg": "",
  "log_id": "20230213140437EEEDFAB3025AEA105C06",
  "data": {
    "data": {
      "error_code": 2100005,
      "description": "Parameter error"
    },
    "extra": {
      "error_code": 2100005,
      "description": "Parameter error",
      "sub_error_code": 0,
      "sub_description": "",
      "now": 1594015876138,
      "log_id": "20230213140437EEEDFAB3025AEA105C06"
    }
  }
}