- 支付
- 私域
- 公域
- 营销
- 资金
- 会员
- 信用
- 安全
- 其他
查询可绑定的商圈查询
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/open/searchbox/businessdistrict/query
错误码#
公共错误码#
业务错误码#
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | NO_PERMISSION | 权限校验失败 | 请确认是否具备对应操作权限 |
| 400 | INVALID_PARAMETER | 参数有误参数有误 | 请参考接口文档检查参数是否正确 |
| 400 | SYSTEM_ERROR | 系统繁忙 | 可能发生了网络或系统异常，导致服务调用失败，可重新发起请求 |
| 400 | SYSTEM_ERROR | 系统繁忙 | 可能发生了网络或系统异常，导致服务调用失败，可重新发起请求 |
| 400 | SYSTEM_ERROR | 系统繁忙 | 可能发生了网络或系统异常，导致服务调用失败，可重新发起请求 |
| 400 | SYSTEM_ERROR | 系统繁忙 | 可能发生了网络或系统异常，导致服务调用失败，可重新发起请求 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/searchbox/businessdistrict/query' \
--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 '{
"brand_id":"1000467882",
"relate_appid_list":[
"2018092561507369"
]
}'响应示例响应示例
200 - 成功示例
{
"business_district_info_list": [
{
"business_district_id": "10000158",
"business_district_name": "商圈名称",
"bindable": true,
"unbindable_error_code": "MCC_NOT_MATCH",
"unbindable_error_msg": "该商圈已被其他品牌直达配置，请选择其他商圈"
}
]
}请求参数
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
brand_id
string
品牌id
relate_appid_list
array[string]
可选
示例
返回响应
🟢200成功
application/json
Body
business_district_info_list
array [object {5}]
商圈信息
business_district_id
string
商圈ID
business_district_name
string
商圈名称
bindable
boolean
必需
unbindable_error_code
string
不可绑定错误码
unbindable_error_msg
string
不可绑定错误码描述
🟠400请求有误