抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • OpenAPI 列表
  • 通用参数
  • 移动/网站应用 OpenAPI SDK 总览
  • 状态码排查工具
  • 个人资料
  • 关系能力
  • 内容能力
  • 搜索能力
  • 私信群聊
  • 生活服务开放能力
  • 工具能力
  • 素材管理
  • 小程序接口能力
  • 沙盒管理
  • ticket 管理
  • 服务市场开放能力
  • 小程序推广计划
  • 联合授权
  • 小程序接口能力
    收藏
    我的收藏

    使用限制

    接口说明

    查询小程序挂载权限。

    基本信息

    名称
    描述
    HTTP URL
    https://open.douyin.com/devtool/micapp/is_legal/
    HTTP Method
    GET
    Scope
    micapp.is_legal
    权限要求
      需要申请权限
      移动网站应用:暂不支持新增申请
      小程序:挂载->短视频挂载->短视频自主挂载能力
      不需要用户授权

    请求头

    参数名称
    类型
    参数描述
    参数示例
    是否必填
    Content-Type
    string
    固定值:application/json
    application/json
    access-token
    string
    接口调用凭证。通过调用 https://open.douyin.com/oauth/client_token/生成的 access_token 字段获取
    clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

    请求参数

    Query

    参数名称
    参数类型
    参数描述
    参数示例
    是否必填
    micapp_id
    string
    小程序appid,进入控制台,找到对应的小程序即可看到
    ba253642-0590-40bc-9bdf-9a1334b94059

    请求示例

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

    响应参数

    参数名称
    参数类型
    参数描述
    参数示例
    extra
    struct
    <nil>
    - sub_description
    string
    子错误码描述
    - sub_error_code
    int64
    子错误码
    0
    - description
    string
    错误码描述
    - error_code
    int64
    错误码
    0
    - logid
    string
    标识请求的唯一 id
    202008121419360101980821035705926A
    - now
    int64
    毫秒级时间戳
    1597213176393
    data
    struct
    <nil>
    - error_code
    i64
    错误码
    0
    - description
    string
    错误码描述
    - is_legal
    bool
    是否合法的信息

    响应示例

    正常示例

    { "extra": { "sub_description": "", "logid": "202008121419360101980821035705926A", "now": 1597213176393, "error_code": 0, "description": "", "sub_error_code": 0 }, "data": { "error_code": 0, "description": "", "is_legal": false } }

    异常示例

    { "data": { "error_code": 2100005, "description": "Parameter error" }, "extra": { "error_code": 2100005, "description": "Parameter error", "sub_error_code": 0, "sub_description": "", "now": 1594015876138, "log_id": "2020070614111601022506808001045D59" } }

    错误码

    HTTP 状态码
    错误码
    错误码描述
    排查建议
    200
    2100005
    Parameter error
    修改参数取值