1.4 设置回调地址

POST

/api/v2/user/notify_url

功能说明

设置通知回调底地址：商品信息变更，订单信息变更

应用场景

商品信息变更，包括但不限于：商品上下架、商品名称、商品图片、商品描述、价格、商品新增等，会发送通知到该指定的地址

订单信息变更：主要包括订单配货、发货（物流快递名称寄单号）

注意事项

商品信息变更通知，用户接受到通知后，应根据商品id，主动调用商品详情接口，获取到商品的最新信息

订单消息通知，在配货通知信息连续三次发送失败后，则发货通知不再发送，用户收到订单回调通知后，主动调用订单详情的接口来获取订单最新信息

用户业务系统可自定义策略，如商品超过7天没有收到过通知的，订单超过24小时没有收到通知的，可分别主动调用商品详情、订单详情，根据接口返回数据主动更新业务系统数据

请求参数

Header 参数

Body 参数application/json

示例

{
    "type": 1,
    "url": "https://www.demo.com/notify/goodss"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://test-openapi.7dingdong.com/api/v2/user/notify_url' \
--header 'appKey: ' \
--header 'token: ' \
--header 'nonce: ' \
--header 'timestamp: ' \
--header 'signature: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": 1,
    "url": "https://www.demo.com/notify/goodss"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "type": 1,
    "url": "https://www.demo.com/notify/goodss"
}

修改于 2025-08-27 08:42:39

1.3 账号基本信息

2.1 省市区列表