能力说明

得物（Poizon）V2 接口文档

基础地址：https://openapi.dajisaas.com
所有得物接口路径前缀均为 /poizonV2/。

1. 概述与接入说明

1.1 支持的能力

关键词搜索、商品详情、预售余额查询、下单与支付、订单查询、取消订单、物流轨迹查询。

1.2 注意事项

1.
得物功能需单独开通。调用任何 /poizonV2/* 接口前，请联系平台为你的 Access Key 开通得物权限。
2.
所有订单均使用预售余额支付。下单前请确保余额充足，可通过【余额查询】接口确认。若下单后采购失败，预售金额将原路退回。
3.
收货地址必须位于中国大陆境内。
4.
得物接口为拉取（pull）模式。平台不会主动推送订单或物流状态，请通过【订单查询】和【物流轨迹查询】主动轮询。
5.
商品搜索关键词：中文关键词传 dwSpuTitle，英文关键词传 distSpuTitle。搜索结果同时返回中英文。
6.
签名规则与其他平台一致 —— 参见【接口签名规则（Sign）】。若已有可用的签名实现，无需改动。

2. 响应格式与错误处理

2.1 标准响应结构（多数接口）

{
  "code": 200,
  "message": "success",
  "data": { },
  "timestamp": 1756012800000,
  "traceId": "a1b2c3d4e5f6",
  "cost": 235
}

字段	类型	说明
code	integer	`200` 表示成功
message	string	结果描述
data	object	业务数据
timestamp	integer	服务器时间戳，UTC 毫秒
traceId	string	链路 ID —— 反馈问题时请一并附上
cost	integer	服务器处理耗时，毫秒

2.2 简化响应结构（关键词搜索、商品详情）

这两个接口返回简化响应结构 —— 注意字段是 msg（非 message），且没有 traceId：

{ "code": 200, "msg": "success", "data": { }, "status": 200 }

每个接口页会标明其使用的响应结构。

2.3 错误响应

失败请求返回 HTTP 400，响应体为 problem-detail 格式 —— 不是上述的标准结构：

{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "40002:order not exist",
  "instance": "/poizonV2/order/cancelOrder"
}

字段	说明
status	HTTP 状态码
detail	错误详情。参数错误格式为 `字段:提示`；得物业务错误为 `错误码:提示`，由得物透传
instance	被调用的接口路径

建议的客户端逻辑： 以 HTTP 2xx 且 code == 200 判定成功；收到 HTTP 400 时读取 detail。

2.4 常见错误

场景	`detail` 示例
缺少必填参数	`requestId:requestId cannot be empty`
Access Key 未开通得物	`site config not found`
签名失败	`sign verify fail`
得物业务错误	`40002:order not exist`
预售余额不足	由得物透传，见 `detail`

得物（Poizon）V2 接口文档#

1. 概述与接入说明#

1.1 支持的能力#

1.2 注意事项#

2. 响应格式与错误处理#

2.1 标准响应结构（多数接口）#

2.2 简化响应结构（关键词搜索、商品详情）#

2.3 错误响应#

2.4 常见错误#