jdl-sdk-node
v1.0.0
Published
京东物流服务端接口的 Node.js 版本封装,暴露出简单的方法函数供调用。(非官方)
Downloads
8
Readme
京东物流 JDL SDK For Node.js
京东物流服务端接口的 Node.js 版本封装,暴露出简单的方法函数供调用。(非官方)
安装
npm install jdl-sdk-node
使用
初始化
// CommonJS
const { JDL } = require("jdl-sdk-node");
// esModule
import { JDL } from "jdl-sdk-node";
// 初始化
const jdl = new JDL({
appKey: "your app key",
appSecret: "your app secret",
accessToken: "your access token",
env: "prod" // 环境参数,可选 prod 、 test, 默认 prod, 测试环境使用 test
});
// 使用 获取运单号
jdl.preGetWaybillCodes([{ orderOrigin: 2, customerCode: "010K000001", sum: 2 }]).then(res => {
console.log(res);
});
options
| 参数名称 | 值描述 | | ----------- | --------------------------------------------------------------------- | | appSecret | 应用的 appSecret,可从【控制台-应用管理-概览】中查看 | | accessToken | “ISV 应用”、“自研商家应用”传值:用户授权完成时平台分配的 access_token | | appKey | 应用的 appKey,可从【控制台-应用管理-概览】中查看 | | env | 环境参数,可选 prod 、 test, 默认 prod, 测试环境使用 test |
注意事项
京东物流要求 所有 API 的入参都是数组包裹的对象 否则报错 code 62
// 错误示例 ❌
jdl.preGetWaybillCodes({ orderOrigin: 2, customerCode: "010K000001", sum: 2 }).then(res => {
console.log(res);
});
// 正确示例 ✅
jdl.preGetWaybillCodes([{ orderOrigin: 2, customerCode: "010K000001", sum: 2 }]).then(res => {
console.log(res);
});
相关文档
- 联调指南 https://cloud.jdl.com/#/open-business-document/access-guide/267/53377
- 业务错误码说明 https://cloud.jdl.com/#/open-business-document/access-guide/267/54365
- API 平台错误码 https://cloud.jdl.com/#/open-business-document/access-guide/267/53215
API
获取运单号
若入参传了「cargoes-货品信息」和「productsReq-产品信息」,则接口校验客户编码下的产品信息,校验通过后出参返回揽收时间范围、支持的产品、预计送达时间以及预估费用
preGetWaybillCodes(data: PreGetWaybillCodesRequest)
下单接口
commonCreateOrderV1(data: object)
订单修改
commonModifyOrderV1(data: object)
订单取消
commonCancelOrderV1(data: object)
订单状态查询
commonGetOrderStatusV1(data: object)
订单轨迹查询
commonGetOrderTraceV1(data: object)
获取运单实时位置
getWaybillGisTrackByWaybillCode(data: object)
查询运单预计送达时间
queryOrderInfoByCondition(data: object)
查询电子签名图片
querySignatureImage(data: object)
查询标价运费
queryFeeResultByBusinessNo(data: object)
实际费用查询
commonGetActualFeeInfoV1(data: object)
物流轨迹订阅
commonSubscribeTraceV1(data: object)