第三方平台
第三方平台概述
创建第三方平台
常见问题排查指南

使用授权码换取小程序的接口调用凭据

使用授权码换取小程序的授权信息,并换取 authorizer_access_token 和 authorizer_refresh_token。 授权码的获取,需要在用户在第三方平台授权页中完成授权流程后,在回调 URI 中通过 URL 参数提供给第三方平台方。

请求地址

GET   https://open.microapp.bytedance.com/openapi/v1/oauth/token

 

Query 参数

参数名参数类型是否必须备注
component_appidstring第三方平台的 appid
component_access_tokenstring第三方平台 access_token
authorization_codestring授权码
grant_typestring固定字符串:app_to_tp_authorization_code

 

返回值

参数名参数类型备注
authorizer_access_tokenstring接口调用令牌
authorizer_refresh_tokenstring刷新令牌主要用于第三方平台获取和刷新已授权用户的 authorizer_access_token。一旦丢失,只能让用户重新授权,才能再次拿到新的刷新令牌。用户重新授权后,之前的刷新令牌会失效
expires_inintauthorizer_access_token 的有效期,单位:秒
authorizer_appidstring授权小程序 appid
authorize_permissionArray<object>授权小程序在授权跳转页勾选的权限

注意:

  • authorizer_access_token 有效期 2 小时
  • authorizer_refresh_token 有效期 1 个月,且只可使用一次,使用后失效

返回值示例

{
    "authorizer_access_token": "xxx",
    "authorizer_refresh_token": "xxx",
    "expires_in": 7200,
    "authorizer_appid": "xxx",
    "authorize_permission": [
        {
            "id": 1,
            "category": "开发管理权限",
            "description": "帮助小程序进行功能开发和开发设置"
        },
        ......
    ]
}

目前可能被授予的权限有:

[
  {
    "id": 1,
    "category": "开发管理权限",
    "description": "帮助小程序进行功能开发和开发设置"
  },
  {
    "id": 2,
    "category": "基本信息设置权限",
    "description": "帮助小程序进行设置名称、头像、简介、服务类目等信息"
  },
  {
    "id": 3,
    "category": "运营管理权限",
    "description": "帮助小程序管理搜索配置、客服消息等相关功能"
  },
  {
    "id": 4,
    "category": "数据分析权限",
    "description": "帮助小程序进行数据分析"
  },
  {
    "id": 5,
    "category": "广告管理权限",
    "description": "帮助小程序进行广告的投放和管理"
  },
  {
    "id": 6,
    "category": "支付服务权限",
    "description": "帮助小程序开通支付服务,获取支付相关信息"
  },
  {
    "id": 7,
    "category": "流量主权限",
    "description": "帮助开发者管理广告变现业务"
  }
]
点击纠错
评价此篇文档