手把手教你创建应用、获取API权限并自动拉取订单到本地系统
作者:鲨鱼 | 时间:2025年7月17日
原创文章,首发于优快云,如需转载,请注明出处。
一、前言
你是否也在为每天手动处理京东订单而烦恼?是否希望用自己团队写的小程序或系统,自动从京东拉取订单、自动发货、甚至做销售分析?
如果你是一个在京东开店的商家,并且有技术团队但不懂如何对接京东开放平台接口,那么这篇文章就是为你量身打造的。
我们将手把手带你完成以下流程:
- 如何注册京东开放平台账号
- 如何完成企业认证
- 如何创建自己的应用
- 如何申请订单相关API权限
- 如何调用API获取订单数据(含完整Python代码示例)
- 如何将订单数据导入你自己的系统中进行发货或分析
二、为什么你应该使用京东开放平台API?
✅ 自动化订单管理
不再手动导出Excel表格,告别复制粘贴错误。
✅ 统一多平台管理
你可以把京东、淘宝、拼多多的订单都同步到一个系统里统一处理。
✅ 实时更新与分析
通过API可以实时获取最新订单状态,支持自动化打单、库存预警、销售趋势分析等功能。
三、准备工作
✅ 1. 注册京东账号
你需要一个有效的京东账号(建议使用企业手机号绑定),用于登录京东开放平台。
👉 官网地址:https://jos.jd.com/
✅ 2. 准备企业资料(企业用户)
虽然你是商家,但在申请API权限时仍需完成实名认证,准备以下材料:
- 营业执照副本扫描件
- 法人身份证正反面
- 开发者联系人信息(邮箱、电话)
- 公章授权书(如非法人本人操作)
四、注册与实名认证流程
✅ 步骤1:访问京东开放平台并登录
打开官网 https://jos.jd.com/,点击右上角【登录】按钮,使用你的京东账号扫码或密码登录。
✅ 步骤2:进入【账户中心】完成实名认证
登录后点击右上角头像 → 【账户中心】 → 【实名认证】
选择认证类型:
- 个人开发者:仅限自然人,可申请部分基础接口。
- 企业开发者:推荐选择,支持申请完整电商类接口。
上传相关材料后提交审核,通常1~3个工作日出结果。
📌 注意:即使你是商家,也必须以“开发者”身份完成认证才能申请API权限。
五、创建应用并配置基本信息
✅ 步骤1:进入【我的应用】页面
实名认证通过后,在首页顶部菜单栏点击【开发者中心】 → 【我的应用】 → 【创建新应用】
✅ 步骤2:填写应用信息
字段名称 | 填写说明 |
---|---|
应用名称 | 必须唯一,建议使用“公司名+系统类型”,如“张氏科技-京东订单系统” |
应用简介 | 简要描述应用功能 |
授权回调地址 | OAuth授权后的跳转URL,必须为HTTPS |
授权域名 | 用户授权页面的域名白名单 |
应用图标 | 上传清晰Logo,大小不超过2MB |
填写完成后点击【提交】,等待应用创建成功。
六、申请接口权限
✅ 步骤1:查看可用接口
进入【我的应用】 → 【接口权限管理】,可以看到当前可申请的接口列表,分为多个模块:
- 订单管理
- 商品管理
- 物流服务
- 用户行为
- 库存管理
✅ 步骤2:根据业务需求申请接口
例如你要拉取订单数据,则需要申请如下接口:
jingdong.pop.order.get
:查询订单详情jingdong.pop.order.search
:搜索订单列表jingdong.pop.order.fbp.splitOrder
:拆单接口jingdong.pop.order.updateRemark
:修改订单备注jingdong.pop.order.delivery
:发货接口
点击【申请】按钮,填写用途说明,并提交审核。
📌 注意:部分接口需要提供详细的功能说明文档或系统截图,否则可能被驳回。
七、获取App Key 和 App Secret
创建应用并通过接口审核后,你可以获取到以下关键凭证:
App Key
App Secret
⚠️ 这两个参数非常重要,用于后续调用API时的身份验证和签名生成,切勿泄露!
八、获取用户授权Token(Access Token)
为了访问店铺订单、商品等数据,你需要引导店铺对你的应用进行授权。
✅ 获取授权码 Code
构造OAuth授权URL:
https://oauth.jd.com/oauth/authorize?
response_type=code&
client_id=your_app_key&
redirect_uri=your_callback_url&
scope=seller_order_get
✅ 换取 Access Token
用户授权后会跳转至你设置的回调地址,获取到 code
后,调用如下接口换取 access_token
:
POST https://oauth.jd.com/oauth/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded
grant_type=authorization_code&
code=your_authorization_code&
client_id=your_app_key&
client_secret=your_app_secret&
redirect_uri=your_callback_url
返回示例:
{
"access_token": "xxxxxx",
"expires_in": 7200,
"refresh_token": "yyyyyy"
}
九、调用API示例(Python)
下面以获取订单列表为例,展示如何调用京东开放平台API:
🧱 安装依赖
pip install requests pycryptodome
🧾 示例代码:获取京东订单列表
import time
import requests
from urllib.parse import quote
from hashlib import md5
from datetime import datetime
def generate_sign(params, app_secret):
"""生成签名"""
keys = sorted(params.keys())
param_str = ''.join([f"{k}{params[k]}" for k in keys])
sign_str = app_secret + param_str + app_secret
return md5(sign_str.encode()).hexdigest().upper()
def get_jd_orders(app_key, app_secret, access_token):
url = "https://api.jd.com/routerjson"
headers = {
"Content-Type": "application/x-www-form-urlencoded"
}
# 构造请求参数
params = {
"method": "jingdong.pop.order.search",
"app_key": app_key,
"timestamp": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
"format": "json",
"v": "2.0",
"sign_method": "md5",
"access_token": access_token,
"360buy_param_json": quote('{"order_state":"WAIT_SELLER_SEND_GOODS","page":1,"page_size":50}')
}
# 生成签名
params["sign"] = generate_sign(params, app_secret)
response = requests.post(url, data=params, headers=headers)
return response.json()
# 示例调用
app_key = 'your_app_key'
app_secret = 'your_app_secret'
access_token = 'your_access_token'
orders = get_jd_orders(app_key, app_secret, access_token)
print(orders)
十、将订单数据写入本地数据库或ERP系统
你可以将上面获取的JSON数据清洗后插入数据库或推送到你自己的订单管理系统中。
例如,将订单转换为结构化格式:
{
"order_id": "123456789",
"customer": "张*",
"status": "待发货",
"amount": 199.00,
"create_time": "2025-07-10T14:30:00"
}
再使用SQL语句写入数据库:
INSERT INTO orders (order_id, customer, status, amount, create_time)
VALUES ('123456789', '张*', '待发货', 199.00, '2025-07-10 14:30:00');
或者调用你自己的ERP系统的API接口进行同步。
十一、常见问题与避坑指南
问题 | 解决方案 |
---|---|
接口提示无权限 | 检查是否已正确申请接口权限并审核通过 |
授权失败:invalid scope | 检查请求中使用的 scope 是否匹配接口要求 |
回调地址不生效 | 确保回调地址已在应用配置中添加且为HTTPS |
access_token过期 | 使用 refresh_token 定期刷新 token |
接口签名错误 | 检查签名算法是否符合官方要求(MD5/HMAC-SHA256) |
接口返回空数据 | 检查订单状态参数是否正确,是否有符合条件的数据 |
十二、结语
作为一位在京东开店的商家,如果你已经有技术团队,但还在手动处理订单、复制粘贴发货,那就太浪费资源了!
通过本文,你应该已经掌握了如何在京东开放平台上完成开发者注册、企业认证、应用创建、接口申请以及获取Token和调用API的完整流程。
无论是做订单同步、发货管理、还是销售数据分析,掌握这些技能都将极大提升你在京东生态中的运营效率。
📌 点赞 + 收藏 + 关注,不错过更多实战干货!
作者简介:
鲨鱼,电商开放平台老司机,从业15年横跨京东、淘宝、拼多多等多个平台,熟悉每一个接口、每一套审核规则。专门为中小商家提供电商系统集成解决方案,帮助你打通平台API,实现自动化运营。