第三方平台
第三方平台概述
创建第三方平台
常见问题排查指南

获取可以设置的服务类目列表

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

请求地址

GET   https://open.microapp.bytedance.com/openapi/v1/microapp/app/all_categories

 

Query 参数

参数名参数类型是否必须备注
component_appidstring第三方平台的 appid
authorizer_access_tokenstring授权小程序的接口调用令牌

 

返回值

参数名参数类型备注
errnoint错误码
messagestring错误信息
dataArray<object>

data 说明:

参数名参数类型备注
idint服务类目 id
namestring服务类目名称
levelint服务类目级别,1:一级类目,2:二级类目,3:三级类目
fpidint一级服务类目 id
spidint二级服务类目 id
certificationobject设置该服务类目需要的资质信息
relationArray<string>需要的资质 id 汇总
listArray<object>需要的资质的详细信息
idstring资质 id
namestring资质名称
explanationstring设置该类目需要上传的的资质解释

返回值示例

{
    "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"
点击纠错
评价此篇文档