开放平台
取消
开放平台
中文
EN
取消
  • 第三方平台 API

    • # 小程序登录

    调试诊断

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

    接口英文名：thirdpartyCode2Session

    # 1. 调用方式

    # HTTPS 调用

    GET https://api.weixin.qq.com/sns/component/jscode2session?appid=APPID&grant_type=GRANT_TYPE&component_appid=COMPONENT_APPID&component_access_token=COMPONENT_ACCESS_TOKEN&js_code=JS_CODE

    # 云调用

    • 本接口不支持云调用

    # 第三方调用

    • 本接口仅支持第三方平台使用。

    # 2. 请求参数

    # 查询参数 Query String parameters

    参数名类型必填说明
    appidstring是小程序的 AppID
    grant_typestring是填 authorization_code
    component_appidstring是第三方平台 appid
    component_access_tokenstring是接口调用凭证，该参数为 URL 参数，非 Body 参数。可通过获取令牌接口获取。
    js_codestring是wx.login 获取的 code

    # 请求体 Request Payload

    无

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    session_keystring会话密钥
    unionidstring用户在开放平台的唯一标识符，若当前小程序已绑定到微信开放平台账号下会返回，详见 UnionID 机制说明。
    openidstring用户唯一标识
    errcodenumber错误码，请求失败时返回
    errmsgstring错误信息，请求失败时返回

    # 4. 注意事项

    • 该接口仅支持服务商获取已有授权关系对的小程序的信息，若小程序尚未授权给第三方平台，则会出现61003报错。

    # 5. 代码示例

    请求示例

    GET https://api.weixin.qq.com/sns/component/jscode2session?appid=APPID&js_code=JSCODE&grant_type=authorization_code&component_appid=COMPONENT_APPID&component_access_token=COMPONENT_ACCESS_TOKEN

    返回示例

    {
  "openid": "OPENID",
  "session_key": "SESSIONKEY",
  "unionid": "oHAUs6LSuwgHq-mlnFrffKXw3QYM"
}

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

    错误码错误描述解决方案
    40029code 无效js_code无效
    41021missing component_access_token
    45011api minute-quota reach limit  mustslower  retry next minuteAPI 调用太频繁，请稍候再试
    61003component is not authorized by this account

    # 7. 适用范围

    本接口支持「第三方平台」账号类型代调用，权限集请参考「调用方式」部分。其他账号类型如无特殊说明，均不可调用。