获取可以设置的服务类目列表
收藏
我的收藏接口介绍
该接口用于第三方小程序应用为授权小程序获取小程序可以设置的服务类目。由于小程序主体的不同(个人或企业),允许设置的服务类目种类也不同。
请求
基本信息
基本 | |
HTTP URL | |
HTTP Method | GET |
权限要求 | 授权小程序授予基本信息设置权限 |
查询参数
参数名 | 参数类型 | 是否必须 | 备注 |
component_appid | string | 是 | 第三方小程序应用 appid |
authorizer_access_token | string | 是 | 授权小程序接口调用凭据 |
响应
响应体
参数名 | 参数类型 | 备注 |
errno | int | 错误码 |
message | string | 错误信息 |
data | Array<object> | |
data 说明:
参数名 | 参数类型 | 备注 | ||
id | int | 服务类目 id | ||
name | string | 服务类目名称 | ||
level | int | 服务类目级别,1:一级类目,2:二级类目,3:三级类目 | ||
fpid | int | 一级服务类目 id | ||
spid | int | 二级服务类目 id | ||
certification | object | 设置该服务类目需要的资质信息 | ||
| relation | Array<string> | 需要的资质 id 汇总 | |
list | Array<object> | 需要的资质的详细信息 | ||
| id | string | 资质 id | |
name | string | 资质名称 | ||
explanation | string | 设置该类目需要上传的的资质解释 |
响应体示例
{ "errno": 0, "message": "success", "data": [ { "id": 259, "name": "直播", "level": 3, "fpid": 158, "spid": 159, "certification": { "relation": ["79|117|158&159"], "list": [ {"id":"79", "name":"《信息网络传播视听节目许可证》"}, {"id":"117", "name":"《网络文化经营许可证》(经营范围含网络表演)"}, {"id":"158", "name":"《统一社会信用代码证》(适用于政府主体)"}, {"id":"159", "name":"《情况说明函件》(适用于政府主体)"} ], "explanation": "需要上传的资质:79或117或158和159" } }, ...... ] }
注意:
- •服务类目 id 和资质 id 数字可能相同,但代表的意思不一样,所以不要混淆。
- •fpid。如果该类目已经是一级类目,则 fpid 为 0。
- •spid。如果该类目是一级类目或二级类目,则 spid 为 0。
- •explanation
如果 relation 字段取值为: "relation": ["5", "10|16", "17|18&122"] 也就是说 5 必传的,10、16 中必须选一个上传,17、18&122 中必须选一个上传(如果选择 18&122,则 18 和 122 都要上传)。 因为在允许的范围内,资质可以多传,但是不能少传。如果想设置该服务类目,但是只上传了资质 5,10,18,则无法通过验证。 则合法的资质组合为: 5 和 10 和 17 5 和 10 和 18 和 122 5 和 16 和 17 5 和 16 和 18 和 122 所以 explanation 字段提示为: "explanation": "需要上传的资质:5、10或16、17或18和122"
错误码
错误码 | message |
40001 | 参数错误 |
40003 | 找不到相关第三方小程序应用 |
40004 | 找不到相关授权小程序 |
40020 | 第三方小程序应用 authorizer_access_token 不正确或者已过期 |
40036 | 授权小程序未授予该接口对应的权限 |