# 获取达人橱窗授权状态
接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南
接口英文名：getwindowauthstatus
可通过该接口获取达人橱窗授权状态
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/league/headsupplier/windowauth/status/get?access_token=ACCESS_TOKEN
# 云调用
调用方法：channels.ec.league.headsupplier.windowauth.status.get
出入参和 HTTPS 调用相同，调用方式可查看 云调用 说明文档
# 第三方调用
- 本接口不支持第三方平台调用。
# 2. 请求参数
# 查询参数 Query String parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证，可使用 access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| finder_id | string | 否 | sph1234 | 视频号finder_id，登录视频号助手可以获取，未填openfinderid时必填，后续废弃。 |
| openfinderid | string | 是 | 视频号openfinderid，【四选一】 | |
| talent_appid | string | 是 | 带货达人appid，【四选一】 | |
| opentalentid | string | 是 | 带货达人opentalentid，【四选一】 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| errcode | number | 0 | 错误码 |
| errmsg | string | ok | 错误信息 |
| window_auth_status | number | 是否授权，0: 未授权, 1: 已授权 | |
| openfinderid | string | 对应的 openfinderid | |
| opentalentid | string | 对应的 opentalentid | |
| nickname | string | - | 达人昵称 |
| head_img_url | string | - | 达人头像 |
# 4. 注意事项
本接口无特殊注意事项
# 5. 代码示例
请求示例
{
"finder_id": "sph1234"
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"window_auth_status": 1,
"openfinderid": "",
"opentalentid": ""
}
# 6. 错误码
以下是本接口的错误码列表，其他错误码可参考 通用错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 10024000 | 参数错误 | |
| 10024001 | 不合法的finder_id |
# 7. 适用范围
本接口暂未明确可调用账号类型，或在业务中根据调用传参自行确定是否可调用，请已实际调用情况为准。