创建抖音搜索直达子服务
开发环境
开发环境
POST
/api/apps/v1/capacity/create_ma_sub_service
权限要求
服务商代调用场景下，需商家授予运营管理权限集
使用限制
接口说明
错误码
| HTTP 状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 11009 | 参数不合法或缺少参数 | 检查body中的字段名及对应值类型是否正确 |
| 200 | 11016 | access_token不正确或已过期 | 重新生成access_token或刷新access_token |
| 200 | 11001 | app_id无法解析 | 重试，若重试不行则重新生成access_token，还不行可使用log_id向内部开发同学反馈 |
| 200 | 40036 | 授权小程序未授予对应的接口权限 | 重新授予相关权限后，刷新access_token重试 |
| 200 | -1 | 系统错误 | 重试，多次重试失败可使用log_id向内部同学反馈 |
| 200 | 28001007 | 参数不合法 | 检查body中的字段名及对应值类型是否正确 |
| 200 | 28005032 | 请勿 重新申请 | 已经使用该名称+关键词+url创建过搜索直达服务，不需要重复创建 |
| 200 | 12004 | 该应用暂不可创建搜索直达服务 | 非内部小程序或行业类目不符合创建要求 |
请求参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/apps/v1/capacity/create_ma_sub_service' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
/** 必传，小程序所提供的
某个服务的关键词，例如有一个宝宝巴士小程序，其中一个功能是
给宝宝起名，那么名称就可以传宝宝起名服务 **/
"sub_service_name": "宝宝起名服务",
// 搜索关键词
"search_key_word": ["宝宝", "起名"],
// 功能页跳转链接
"start_page_url": "xxxxx"
}'响应示例响应示例
200 - 成功示例
{
"err_no": 0,
"err_msg": "success",
"log_id": "xxx",
"data": {}
}
修改于 2025-11-07 10:12:29