概要

本文章详细介绍云仓礼品代发API的功能、调用方式、参数说明及返回数据解析，可快速接入礼品代发API接口，适用于电商私域营销以及回馈粉丝等场景。

礼品代发API介绍

云仓礼品代发API是通过集成云仓系统提供的礼品代发服务接口，可实现：

• 自动下单：通过API快速提交礼品代发订单

• 物流同步：实时获取物流单号及物流轨迹

• 库存查询：获取礼品SKU库存及价格

• 订单管理：查询、修改、取消订单

应用场景：

　　1.电商礼品代发

　　2.粉丝活动赠品

　　3.线下活动礼品

请求信息

请求参数

1. 下单接口（/order/create）

{
  "app_key": "您的API密钥",
  "receiver_name": "收货人姓名",
  "receiver_phone": "收货人手机号",
  "receiver_address": "收货地址",
  "gift_id": "礼品SKU编号",
  "quantity": 1,
  "timestamp": "当前时间戳（秒级）",
  "sign": "请求签名（见下方签名算法）"
}

2. 查询物流接口（/order/logistics）

返回参数

1. 下单成功响应（200）

{
  "code": 200,
  "data": {
    "order_id": "YC202405290001",
    "gift_name": "精美保温杯",
    "logistics_no": "YT123456789",
    "logistics_company": "圆通速递",
    "estimate_arrival": "2024-06-02"
  }
}

2. 物流状态查询

{
  "code": 200,
  "data": {
    "logistics_status": "已发货",
    "logistics_traces": [
      {
        "time": "2025-05-29 14:00",
        "info": "已揽收"
      }
    ]
  }
}

3. 错误码对照表

调用示例

import requests
import time

api_url = "https://tool.sd1118.com/document/detail/7/4"
params = {
    "app_key": "YOUR_API_KEY",
    "receiver_name": "张三",
    "receiver_phone": "13800138000",
    "receiver_address": "上海市虹桥区",
    "gift_id": "GIFT1001",
    "quantity": 1,
    "timestamp": int(time.time())
}
params["sign"] = generate_sign(params, "YOUR_API_SECRET")  # 使用前文签名函数

response = requests.post(api_url, json=params)
print(response.json())

注意事项

1. 频率限制：单IP限制100次/分钟，超频将临时封禁

2. 订单超时：未支付订单5分钟后自动关闭

3. 物流更新：物流信息每半小时同步一次，非实时

4. 合规使用：禁止用于虚假交易等违规行为