小程序升级成品牌直达
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/open/searchbox/upgrade/save
错误码
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | NO_PERMISSION | 权限校验失败 | 请确认是否具备对应操作权限 |
| 400 | BRAND_HAS_CONFIG_SEARCH_BOX | 该品牌已申请过品牌直达 | 请勿重复申请 |
| 400 | APP_HAS_CONFIG_SEARCH_BOX | 该应用已申请过品牌直达 | 请勿重复申请 |
| 400 | INVALID_PARAMETER | 参数有误输入参数为空，或相应服务、关联账号参数无效 | 请参考接口文档检查参数是否正确，服务是否已经审批上线 |
| 400 | INVALID_PARAMETER | 参数有误参数非法 | 请参考接口文档检查参数是否正确 |
| 400 | ISV_NOT_AUTH | 服务商未被商家授权 | 请找对应商家授权 |
| 400 | RELATED_ACCOUNT_NO_TINY_APP | 关联账号至少要传一个小程序 | 关联账号至少要传一个小程序 |
| 400 | SYSTEM_ERROR | 系统繁忙 | 可能发生了网络或系统异常，导致服务调用失败，可重新发起请求 |
| 400 | SYSTEM_ERROR | 系统繁忙 | 可能发生了网络或系统异常，导致服务调用失败，可重新发起请求 |
| 400 | SYSTEM_ERROR | 系统繁忙 | 可能发生了网络或系统异常，导致服务调用失败，可重新发起请求 |
| 400 | SYSTEM_ERROR | 系统繁忙 | 可能发生了网络或系统异常，导致服务调用失败，可重新发起请求 |
| 400 | SEARCH_BOX_ACCESS_CHECK_FAIL | 搜索直达准入校验失败 | 请确认是否符合准入条件，参考 搜索直达准入条件 |
| 400 | UN_SUPPORT_SEARCH_BOX | 不支持的搜索直达类型 | 当前搜索直达类型不支升级，请检查参数是否正确 |
| 400 | UN_SUPPORT_SEARCH_BOX_STATUS | 不支持的状态类型 | 只有上架状态的搜索直达才能升级，请检查搜索直达状态 |
| 400 | BUSINESS_DISTRICT_HAS_SEARCH_BOX | 商圈已申请搜索直达 | 请勿重复申请 |
| 400 | SYSTEM_ERROR | 系统繁忙 | 可能发生了网络或系统异常，导致服务调用失败，可重新发起请求 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/searchbox/upgrade/save' \
--header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \
--header 'alipay-request-id: $requestid' \
--header 'Content-Type: application/json' \
--data-raw '{
"box_id":"20220308000000128693",
"brand_id":"1000467882",
"service_infos":[
{
"service_code":"2021012121000864802961",
"service_name":"点餐",
"service_category_code":"XS2075",
"service_category_name":"点餐与排队"
}
],
"related_accounts":[
{
"app_type":"TINY_APP",
"relate_appid":"2018061360108419",
"app_name":"小程序名称"
}
],
"custom_keywords":[
"自定义触发词"
],
"box_desc":"品牌介绍",
"image_id":"A*oZQmT4xTBPUAAAAAAAAAAAAAAQAAAQ",
"image_name":"氛围图1",
"area_keywords":[
"简称触发词"
],
"business_district_ids":[
"商圈id"
],
"business_benefit_switch":false
}'响应示例响应示例
200 - 示例 1
{}请求参数
Header 参数
authorization
string
必需
示例值:
ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign
alipay-request-id
string
必需
示例值:
$requestid
Content-Type
string
必需
示例值:
application/json
Body 参数application/json