搜索直达升级准入

搜直达升级准入

错误码

公共错误码

业务错误码

状态码	错误码	错误描述	解决方案
400	INPUT_ARGUMENT_ILLEGAL	输入参数非法	请参考接口文档检查参数是否正确
400	NO_PERMISSION	权限校验失败	请确认是否具备对应操作权限
400	SYSTEM_ERROR	系统繁忙	可能发生了网络或系统异常，导致服务调用失败，可重新发起请求
400	ISV_NOT_AUTH	服务商未被商家授权	请找对应商家授权
400	SYSTEM_ERROR	系统繁忙	可能发生了网络或系统异常，导致服务调用失败，可重新发起请求
400	SYSTEM_ERROR	系统繁忙	可能发生了网络或系统异常，导致服务调用失败，可重新发起请求
400	UN_SUPPORT_SEARCH_BOX	不支持的搜索直达类型	请检查搜索直达类型
400	UN_SUPPORT_SEARCH_BOX_STATUS	不支持的状态类型	请检查搜索直达的状态

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/searchbox/upgrade/preconsult' \ --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":"20221201000000126208" }'

{ "opt_principal_id": "562001275", "applicable_box_type": "brand_box", "access_check_info": { "access_check": false, "check_item_info_list": [ { "rule_id": "RELATED_ACCOUNT_EXIST_APP_MCC_INVALID", "rule_name": "应用搜索可见", "tips": "已关联至少一个小程序", "access_check": true } ] }, "brand_cert_info": { "brand_id": "10600086367", "brand_name_cn": "品牌中文名", "brand_name_en": "品牌英文名", "brand_cert": false }, "tiny_app_info": { "app_type": "TINY_APP", "relate_appid": "2018061360108419", "app_name": "小程序名称" } }

请求参数

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

box_id

string

搜索直达boxId

必需

示例

返回响应

🟢200成功

application/json

Body

opt_principal_id

string

可选

运营主体id;applicableBoxType不为空时,返回值不为空;品牌直达返回品牌id，其他直达返回小程序id

applicable_box_type

string

可选

可申请的box类型; 为空代表不满足条件, 可通过 access_check_info查看不匹配规则详情枚举值品牌直达: brand_box 小程序直达: tiny_app_box 政府直达: gov_box 事业单位直达: institution_box

access_check_info

object

准入校验

可选

access_check

boolean

必需

check_item_info_list

array [object {4}]

必需

brand_cert_info

object

品牌认证信息

可选

brand_id

string

必需

brand_name_cn

string

必需

brand_name_en

string

必需

brand_cert

boolean

必需

tiny_app_info

object

小程序信息

可选

app_type

string

必需

relate_appid

string

必需

app_name

string

必需

🟠400请求有误

搜索直达升级准入

错误码#

公共错误码#

业务错误码#

请求参数

返回响应

错误码

公共错误码

业务错误码