NB NB Agent API Demo

代理询价

用于演示商家在下单前通过 API 获取产品渠道价格。页面内包含正式接口说明、字段约束、请求示例、响应示例和可直接发送的测试区。

商家联调测试台
Get Product Price API v1
POST
请求方式
未设置
当前 API 名称
未填写
API Key 状态
JSON
请求内容类型

接口文档

请求地址
请求方式
POST
Content-Type
application/json
请求头
apikey: 左侧共用配置中填写的测试 Key
字段说明
字段名类型 / 是否必填说明
shipperOriginString / 选填发货始发地,格式按“/”分割,例如 Canada/ON/Toronto,length < 100。
shipperPostalCodeString / 必填始发地邮编,例如 V7H 2X5,length < 50。
receiverDestString / 必填收货地,格式按“/”分割,例如 Canada/ON/Ajax,length < 100。
receiverPostalCodeString / 必填收货地邮编,例如 M9W0E6,length < 50。
unitTypeInteger / 选填单位制,1 = 公制,2 = 英法制;默认 1。
remarkString / 选填询价备注,length < 255。
storeOrderGoodsList / 必填货物信息列表,至少包含一项,每项请参考下方“货物信息说明”。

货物信息说明

storeOrderGoods 中每个对象包含:lengthwidthheightweight(均为必填,需大于 0.01,精确 2 位小数),其中重量最大 68kg / 150lb;goodValuegoodInforemark 为选填。

响应说明

code:0 成功 / 1 失败;msg:成功或失败描述;data:响应数据详情,失败时为 null;ok/OK:请求结果状态,true 成功,false 失败。

{
  "code": 1,
  "msg": "始发地-邮编不能为空!",
  "OK": false
}

{
  "code": 1,
  "msg": "收货地-邮编不能为空!",
  "OK": false
}

{
  "code": 0,
  "msg": null,
  "data": [
    {
      "agentDiscountAmount": 39.34,
      "agentTaxAmount": 4.77,
      "channelCode": "NGR"
    },
    {
      "agentDiscountAmount": 46.37,
      "agentTaxAmount": 5.62,
      "channelCode": "NSAA"
    }
  ],
  "ok": true
}

在线测试

实时响应

响应状态
--
耗时
--
API 名称
--
点击“发送请求”后,这里会显示接口返回内容。

cURL 参考

发送请求后会自动生成对应的 cURL 示例。