礼品开放平台
    礼品开放平台
    • 对接前必看
    • 获取用户信息
      GET
    • 获取可用平台列表
      GET
    • 获取快递列表
      GET
    • 创建订单
      POST
    • 获取订单详情
      POST

      创建订单

      POST
      /open/api/v2/create_order

      请求参数

      Header 参数
      pg-open-key
      string 
      必需
      示例值:
      9a58b404a49c50bdb1696e0d55715d94
      pg-signature
      string 
      必需
      示例值:
      e0cc12fc8500f28bff256e9f2ccba4ef
      pg-timestamp
      string 
      必需
      示例值:
      1730300642
      Body 参数application/json
      goodsId
      integer 
      礼品id
      必需
      sendName
      string 
      发货人姓名
      必需
      sendPhone
      string 
      发货人联系电话
      必需
      sendProvince
      string 
      发货人省份
      必需
      sendCity
      string 
      发货人城市
      必需
      sendCounty
      string 
      发货人区县
      必需
      sendAddress
      string 
      发货人详细地址
      必需
      platformCode
      integer 
      平台编码
      可选
      addressList
      array [object {8}] 
      地址列表
      必需
      uuid
      string 
      唯一标识
      必需
      cname
      string 
      收货人姓名
      必需
      phone
      string 
      收货人联系电话
      必需
      orderSn
      string 
      可选
      电商平台单号,有就传!!!,没就留空!!!,不要乱传一样的进来,可能会导致你后台查询有问题。
      province
      string 
      收货人省份
      必需
      city
      string 
      收货人城市
      必需
      county
      string 
      收货人区县
      必需
      address
      string 
      收货人详细地址
      必需
      示例
      {
          "goodsId": 1,
          "sendName": "张三",
          "sendPhone": "18866665555",
          "sendProvince": "广东省",
          "sendCity": "广州市",
          "sendCountyName": "白云区",
          "sendAddress": "xxx楼xxx栋",
          "addressList": [
              {
                  "uuid": "0123456789",
                  "cname": "李四",
                  "phone": "18822223333",
                  "orderSn": "000000",
                  "province": "广东省",
                  "city": "广州市",
                  "county": "天河区",
                  "address": "xxxx楼xxx栋"
              }
          ]
      }

      示例代码

      Shell
      JavaScript
      Java
      Swift
      Go
      PHP
      Python
      HTTP
      C
      C#
      Objective-C
      Ruby
      OCaml
      Dart
      R
      请求示例请求示例
      Shell
      JavaScript
      Java
      Swift
      curl --location --request POST '/open/api/v2/create_order' \
      --header 'pg-open-key: 9a58b404a49c50bdb1696e0d55715d94' \
      --header 'pg-signature: e0cc12fc8500f28bff256e9f2ccba4ef' \
      --header 'pg-timestamp: 1730300642' \
      --header 'Content-Type: application/json' \
      --data-raw '{
          "goodsId": 1,
          "sendName": "张三",
          "sendPhone": "18866665555",
          "sendProvince": "广东省",
          "sendCity": "广州市",
          "sendCountyName": "白云区",
          "sendAddress": "xxx楼xxx栋",
          "addressList": [
              {
                  "uuid": "0123456789",
                  "cname": "李四",
                  "phone": "18822223333",
                  "orderSn": "000000",
                  "province": "广东省",
                  "city": "广州市",
                  "county": "天河区",
                  "address": "xxxx楼xxx栋"
              }
          ]
      }'

      返回响应

      🟢200成功
      application/json
      Body
      msg
      string 
      响应消息
      必需
      code
      integer 
      必需
      响应代码非200均是异常
      data
      object 
      响应内容
      必需
      01234567811
      object 
      订单唯一标识
      必需
      01234567891
      object 
      订单唯一标识
      必需
      示例
      {
          "msg": "操作成功",
          "code": 200,
          "data": {
              "01234567811": {
                  "status": 1,
                  "errorMsg": "",
                  "trackingNumber": "dev_42012804"
              },
              "01234567891": {
                  "status": 1,
                  "errorMsg": "",
                  "trackingNumber": "dev_98065214"
              }
          }
      }
      上一页
      获取快递列表
      下一页
      获取订单详情
      Built with