接口介绍

该接口用于第三方小程序应用为授权小程序获取小程序可以设置的服务类目。由于小程序主体的不同(个人或企业),允许设置的服务类目种类也不同。

请求

基本信息

基本
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 必传的,1016 中必须选一个上传,1718&122 中必须选一个上传(如果选择 18&122,则 18122 都要上传)。 因为在允许的范围内,资质可以多传,但是不能少传。如果想设置该服务类目,但是只上传了资质 51018,则无法通过验证。 则合法的资质组合为: 51017 51018122 51617 51618122 所以 explanation 字段提示为: "explanation": "需要上传的资质:5、10或16、17或18和122"

错误码

错误码
message
40001
参数错误
40003
找不到相关第三方小程序应用
40004
找不到相关授权小程序
40020
第三方小程序应用 authorizer_access_token 不正确或者已过期
40036
授权小程序未授予该接口对应的权限