接口说明

在使用创建抖音搜索直达子服务的 openApi 创建相关服务后，开发者可以调用此接口来查询创建服务的审核状态以及服务的具体信息。

业务场景：调用此接口来查询创建搜索直达子服务的审核状态以及服务的具体信息，包含服务所在的小程序id，服务的id（服务唯一标识），服务的名称，服务的关键词，服务创建时间，审核未通过的具体原因等。

使用限制

暂无

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/apps/v1/capacity/query_ma_sub_service/
HTTP Method	GET
Scope	ma.search.direct
权限要求	服务商代调用场景下，需商家授予运营管理权限集

请求参数

请求头

access-token必填String

当非服务商时，调用https://developer.toutiao.com/api/apps/v2/token生成的token
当服务商时，调用https://open.microapp.bytedance.com/openapi/v1/oauth/token生成的token

content-type必填String

示例：application/json

固定值"application/json"

Query

page_no必填Int64

示例：1

查询的页号，从1开始

page_size必填Int64

示例：10

查询一页的大小，从1开始

approval_stateInt64

要查询已创建服务的状态类型，0-审核中/1-已通过/2-未通过，传0就表示只查状态为审核中的服务，不传就表示查询全部状态的服务

请求示例
curl --location --request GET 'https://open.douyin.com/api/apps/v1/capacity/query_ma_sub_service/?TpAppId=Kj0Wkxkl0t' \
--header 'content-type: application/json' \
--header 'access-token: clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1******' \
--data '{"approval_state":1,"page_no":1,"page_size":5}'

响应参数

Body展开全部子属性

data必填Struct

展开子属性

err_msg必填String

示例：access_token过期,请刷新或重新授权

成功时为空，失败时为具体错误信息

err_no必填Int32

示例：28005041

错误码，0是成功，其他是异常错误码

log_id必填String

示例：202312201107018A51A88B7380FA4xxxxx

log_id，用于向内部开发人员进行反馈

响应示例
正常响应示例异常响应示例
{
  "data": {
    "has_more": false,
    "ma_sub_service_info_list": [
      {
        "create_time": "2023-12-21 15:43:02",
        "micro_app_icon": "******",
        "micro_app_id": "******",
        "search_key_word": [
          "******",
          "******"
        ],
        "start_page_url": "******",
        "sub_service_id": "******",
        "sub_service_name": "******",
        "approval_state": 0
      },
      {
        "sub_service_id": "*****",
        "sub_service_name": "*****",
        "approval_state": 0,
        "create_time": "2023-12-20 14:20:55",
        "micro_app_icon": "",
        "micro_app_id": "******",
        "search_key_word": [
          "*****1",
          "*****2"
        ],
        "start_page_url": "*****"
      }
    ],
    "total": 2
  },
  "err_msg": "",
  "err_no": 0,
  "log_id": "202311231517488305C037A785Dxxxxx"
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	29003024	请求参数不合法	检查参数合法性
200	28001003	access_token无效	检查access_token合法性
200	28001006	网络调用错误	建议重试
200	28001018	应用未获得该能力	引导商家授予相关权限集
200	28001005	系统内部错误，请重试	建议重试

开发者文档

查询已创建的抖音搜索直达子服务列表

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

查询已创建的抖音搜索直达子服务列表在线调试

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

查询已创建的抖音搜索直达子服务列表