京东订单API接口参数详解（含调用示例）

---

接口文档说明 + 实战调用指南

作者：鲨鱼 | 时间：2025年7月14日
原创文章，首发于优快云，如需转载，请注明出处。

---

一、前言

随着电商行业的快速发展，越来越多的商家和系统服务商希望通过自动化方式获取京东订单数据，用于ERP、OMS、WMS等系统的集成与管理。京东开放平台（Jingdong Open Service, JOS）提供了丰富的API接口，支持开发者拉取订单信息、处理售后请求、同步物流状态等。

本文将详细介绍京东订单相关的核心API接口参数，并提供实际调用示例，帮助你快速上手开发。

---

二、京东订单核心API接口介绍

接口名称	功能描述
jd.order.search	搜索并分页获取订单列表
jd.order.detail.get	获取单个订单详细信息
jd.order.state.update	更新订单状态（如发货）
jd.order.sop.outstorage	订单出库操作
jd.order.vender.remark.update	更新订单备注信息

本文将以最常用的接口为例进行讲解：

✅ 示例接口：

jd.order.search

该接口用于分页查询京东店铺的订单列表，支持根据时间范围、订单状态、订单编号等条件筛选。

---

三、接口请求参数说明

📌 请求方式：

HTTP POST

📌 请求地址：

https://api.jd.com/routerjson

📌 必填参数说明：

参数名	类型	是否必填	描述
method	String	是	调用的方法名，例如 jd.order.search
app_key	String	是	应用的App Key
timestamp	String	是	当前时间戳（格式：yyyy-MM-dd HH:mm:ss）
format	String	否	返回格式，默认为 json
v	String	是	API协议版本号，目前统一为 2.0
sign	String	是	请求签名值，根据其他参数生成
access_token	String	是	用户授权Token（通过OAuth获得）
pageNo	Integer	是	分页页码（从1开始）
pageSize	Integer	是	每页记录数（最大支持100）
timeType	Integer	否	时间类型（1-下单时间，2-付款时间，3-更新时间）
startTime	String	否	查询起始时间（格式：yyyy-MM-dd HH:mm:ss）
endTime	String	否	查询结束时间（格式：yyyy-MM-dd HH:mm:ss）
orderState	String	否	订单状态（多个状态可用逗号分隔）

---

四、签名机制说明（Sign）

京东API要求每个请求都必须携带签名，防止伪造请求。

✅ 签名算法步骤如下：

1. 将所有请求参数按字母顺序排序；
2. 拼接成 key=value 的字符串；
3. 在拼接后的字符串前后加上 App Secret；
4. 使用 MD5 加密，结果转大写。

示例代码（Python）：

import hashlib

def generate_sign(params, app_secret):
    sorted_params = sorted(params.items())
    param_str = ''.join([f"{k}{v}" for k, v in sorted_params])
    sign = hashlib.md5((param_str + app_secret).encode()).hexdigest()
    return sign.upper()

params = {
    "method": "jd.order.search",
    "app_key": "your_app_key",
    "timestamp": "2025-07-14 10:00:00",
    "v": "2.0",
    "pageNo": "1",
    "pageSize": "50",
    "startTime": "2025-07-10 00:00:00",
    "endTime": "2025-07-14 23:59:59"
}

app_secret = "your_app_secret"
sign = generate_sign(params, app_secret)
print("Sign:", sign)

---

五、完整请求示例（含参数组装）

POST https://api.jd.com/routerjson HTTP/1.1
Content-Type: application/x-www-form-urlencoded

method=jd.order.search
&app_key=your_app_key
&timestamp=2025-07-14+10%3A00%3A00
&format=json
&v=2.0
&pageNo=1
&pageSize=50
&startTime=2025-07-10+00%3A00%3A00
&endTime=2025-07-14+23%3A59%3A59
&access_token=your_access_token
&sign=ABCD1234EFGH5678

---

六、返回数据结构说明（JSON）

成功调用后，返回的 JSON 数据结构如下：

{
  "jingdong_order_search_responce": {
    "orderVOList": [
      {
        "orderId": "1234567890",
        "orderAmount": 99.00,
        "status": "WAIT_SELLER_STOCK_OUT",
        "buyerNick": "张*",
        "createdTime": "2025-07-10T14:30:00",
        "paymentTime": "2025-07-10T15:00:00"
      },
      ...
    ],
    "total": 100
  }
}

---

七、常见错误码及处理建议

错误码	含义	解决方案
2000	服务繁忙	稍后重试或联系京东技术支持
2500	系统异常	检查网络或稍后再试
27	签名失败	检查签名算法是否正确
40006	参数缺失	检查 pageNo 或 pageSize 是否传入
40001	Token失效	重新授权获取新 Token
40002	应用未授权	检查应用权限是否开通

---

八、开发调试工具推荐

工具名称	用途
Postman	快速模拟HTTP请求
京东SDK	官方提供的多种语言SDK
京东开放平台	查看接口文档、申请权限
日志分析工具	如 ELK、Logstash，用于排查线上问题

---

九、结语

京东订单接口是电商系统对接中非常关键的一环，掌握其参数结构和调用流程对于ERP系统、订单管理系统、数据分析平台等开发至关重要。

如果你是一个中小卖家，或者不想自己开发，我们还提供一种无需申请API、无需编写代码的一站式订单同步服务，帮助你快速获取京东订单数据。

---

📌 点赞 + 收藏 + 关注，不错过更多电商API实战干货！

---

作者简介：
鲨鱼，电商开放平台老司机，从业15年横跨京东、淘宝、拼多多等多个平台，熟悉每一个接口、每一套审核规则。无论是API签名、Token管理，还是应用上线避坑，都能手把手带你走通，电商圈里摸爬滚打了15年的老伙计，从京东到淘宝、从拼多多到唯品会，几乎所有平台都玩过一遍。想少踩坑？找我就对了！

---