小程序c端联合授权获取openid
收藏开发者可通过此 OpenAPI 查询授权后的绑定关系对应的openid。
使用限制
- •对开发者的scope有校验，需要开发者在控制台申请相关能力，详情参见：
- •开发者需要在控制台进行发起和接受绑定关系操作，详情参见：联合授权获取用户标识能力
- •需要用户在c端完成userinfo和phonenumber授权，详情参见：联合授权获取用户标识能力
- •用户授权持续2小时
接口说明
- •前置条件：使用该 OpenAPI，请确保您已知悉联合授权的内容以及效果。
- •业务场景：开发者可通过此 OpenAPI 查询授权后的绑定关系对应的openid。
- •产品详情具体可参见：联合授权获取用户标识能力
- •B端和C端操作具体可参见：联合授权获取用户标识能力
基本信息
名称 | 描述 |
HTTP URL | |
HTTP Method | POST |
Scope | unionauth.identification |
权限要求 | 需要用户在userinfo和phonenumber授权； 控制台对应地址申请scope权限。 |
请求头
名称 | 类型 | 必填 | 描述 |
access-token | string | 是 | access_token 是小程序的全局唯一调用凭据。 是 access-token，不是 access_token。 |
请求参数
Body
名称 | 类型 | 是否必填 | 描述 | 默认值 |
b_client_key | string | 是 | 绑定的b端应用id。 | 无默认值，开发者自行填写 |
c_client_key | string | 是 | 小程序的appid。 | 无默认值，开发者自行填写 |
open_id | string | 是 | 无默认值，开发者自行填写 |
请求示例
{ "b_client_key":"XXXXXX", "c_client_key":"XXXXXX", "open_id":"XXXXXXX" }
响应参数
名称 | 类型 | 是否必填 | 描述 | 默认值 |
err_no | number | 是 | 错误码 | |
err_msg | string | 是 | 错误信息 | |
log_id | string | 是 | log_id，用于向内部开发人员进行反馈 | |
data | object | 是 | 响应结果 | {} |
响应示例
正常示例
{ "err_no": 0, "err_msg": "success", "log_id": "xxxx", "data": { "open_id": "xxxx" // 用户在b端应用对应的open_id } }
异常示例
{ "err_no": -1, "err_msg": "系统错误", "log_id": "xxxx", "data": { } }
错误码
HTTP 状态码 | 错误码 | 描述 | 排查建议 |
200 | 28001003 | accesstoken无效 | 检查当前票据是否有效，建议重新获取 |
200 | 28005007 | 参数校验异常 | 入参非空字段，需要自行排查 |
200 | 29003003 | 系统异常 | 重试 |
200 | 28005096 | bc端应用未绑定 | 参考接口说明和使用限制所列文档，进行联合授权绑定 |
200 | 28005097 | 用户未授权 | 参考使用限制文档，需要用户在客户端授权 |
