• OpenAPI 简介
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 联合授权
  • 视频能力
  • 线索组件
  • 接口调用凭证
  • 经营能力调用凭证
  • 非用户授权调用凭证
  • 获取应用授权调用凭证
  • getAccessToken
  • 用户授权调用凭证
  • 登录
  • Web 化接入
  • 隐私协议
  • 流量主
  • 小程序码与小程序链接
  • 用户信息
  • 抖音号绑定
  • 小程序推广计划
  • 内容安全
  • 任务能力
  • 分享
  • 客服
  • 小程序券
  • 触达与营销
  • 支付
  • 运营
  • 生活服务
  • 垂直行业
  • 其它
  • 接口说明

    为了保障应用的数据安全,只能在开发者服务器使用 AppSecret,如果小程序存在泄露 AppSecret 的问题,字节小程序平台将有可能下架该小程序,并暂停该小程序相关服务。​

    access_token 是小程序的全局唯一调用凭据,开发者调用小程序支付时需要使用 access_token。access_token 的有效期为 2 个小时,需要定时刷新 access_token,重复获取会导致之前一次获取的 access_token 的有效期缩短为 5 分钟。​

    后续会新增和抖音能力 client_token 相通的接口,各 openapi 支持 client_token 调用,建议开发者逐步迁移新接口。

    基本信息

    名称描述
    HTTP URL
    HTTP Method
    POST
    Scope
    ma.clientToken

    请求参数

    请求头
    content-type必填String
    示例:application/json
    固定值"application/json"
    Body
    appid必填String

    小程序 ID

    grant_type必填String

    获取 access_token 时值为 client_credential

    secret必填String

    小程序的 APP Secret,可以在开发者后台获取

    响应参数

    Body展开全部子属性
    dataStruct
    展开子属性
    err_noEnum
    展开子属性
    err_tipsString
    响应示例
    正常响应示例异常响应示例
    { "err_no": 0, "err_tips": "success", "data": { "access_token": "0801121***********", "expires_in": 7200 } }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    2000
    请求成功
    200-1
    系统错误
    20040015
    appid 错误
    20040017
    secret 错误
    20040020
    grant_type 不是 client_credential