履约信息查询接口

该接口用于查询履约信息

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/app/delivery/info/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 '{ "delivery_type":"EXPRESS", "delivery_ids":[ "20230530021000800000001" ] }'

{ "delivery_infos": [ { "delivery_id": "20230530021000800000001", "delivery_type": "SAME_CITY", "delivery_name": "同城配送满30元起送", "attrs": [ { "attr_key": "key1", "attr_value": "value1" } ] } ] }

请求参数

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

delivery_type

string

必需

【描述】该入参需要和履约信息ID列表不能同时为空，会查询对应appId下的该种履约类型的履约信息，最大查询数量500条【枚举值】电商卖货: EXPRESS 外送到家: SAME_CITY 到店自提: PICKUP 【示例值】EXPRESS

delivery_ids

array[string]

可选

【描述】查询的履约ID列表，与履约类型不能同时为空。建议接入方在履约同步时持久化存储履约ID信息，最大支持上限500 【注意事项】若该字段与delivery_type均非空时，优先根据该字段进行查询【示例值】["20230530021000800000001"]

示例

application/json

Body

delivery_infos

array [object {4}]

必需

【描述】履约信息列表

delivery_id

string

可选

delivery_type

string

可选

delivery_name

string

可选

attrs

array [object {2}]

可选

履约信息查询接口

请求参数

返回响应