京東開放平台（JOS）接入全指南

2025-04-27

引言

在當今電商飛速發展的時代，開放平台已成為各大電商企業連接合作夥伴、擴展生態的重要利器。京東開放平台（Jingdong Open Platform，簡稱 JOS），正是京東為開發者、ISV 及合作夥伴提供的一站式電商能力服務。透過它，你可以獲取商品資訊、管理訂單、同步庫存、調度物流，甚至進行行銷推廣，幾乎涵蓋了一個電商系統的所有核心環節，是連接京東生態不可或缺的橋樑。

一、平台介紹

1. 什麼是京東開放平台？

京東開放平台（Jingdong Open Platform，JOS）是京東面向第三方開發者推出的電商能力開放服務，覆蓋商品管理、訂單交易、倉儲物流、行銷推廣等多個模組。自 2012 年上線以來，已支持個人開發者、企業及 ISV 多種身份接入，幫助合作夥伴快速構建與京東生態對接的應用與解決方案。

核心能力模組

商品管理
- 商品查詢、上下架控制
- 庫存同步、價格更新
訂單與交易
- 訂單創建、查詢、取消
- 退款申請、售後工單管理
倉儲與物流
- 秒送服務、雲倉對接
- 運費計算、物流跟蹤查詢
行銷推廣
- 京準通廣告投放
- 京東聯盟商品推廣分潤

透過以上能力，開發者可以基於京東既有的豐富資源，迅速搭建品牌官方網站、分銷系統、ERP打通、數據分析平台等多樣化應用場景，實現業務增長與效率提升。

二、開發者帳號註冊

在開始調用 API 之前，首先需完成開發者身份的註冊與認證。京東開放平台支持三種主要身份類型：個人開發者、企業開發者和 ISV 服務商，對應不同的接入需求。

身份類型	適用場景	主要資質要求
個人開發者	學習、測試或小規模應用	有效身分證，完成實名認證
企業開發者	正式商業項目、品牌商或分銷商	營業執照、對公銀行帳戶
ISV服務商	多商家代運營、系統集成商	入駐京東雲鼎、軟體著作權證、接口方案書

註冊流程

訪問入口
打開瀏覽器，進入京東開放平台主頁，使用京東帳號登入。
選擇帳號類型
登入後，點擊右上角「成為開發者」，根據自身需求選擇個人或企業帳號，並填寫相應資質資訊。
身份驗證
- 個人：上傳身份證照片並完成人臉核驗；
- 企業：提交營業執照掃描件、公司章程、對公帳戶資訊等。
等待審核
京東平台將於 1–3 個工作日內完成審核，審核通過後即可在「開發者中心」看到已激活的開發者帳號。

小提示：
若以個人開發者身份註冊，可先使用沙箱環境進行學習與測試。但如需調用正式接口、上架應用至「應用商店」或使用高級服務，必須升級為企業或ISV身份並通過完整資質審核。

三、創建應用並獲取 API 密鑰

帳號激活後，接下來是創建應用（Application），在應用中配置所需權限，才能獲取調用 API 所需的憑證（AppKey & AppSecret）。

1. 新建應用

在「開發者中心」左側導航選擇「我的應用」→「新建應用」。
填寫應用基本資訊：
- 應用名稱：建議包含業務場景關鍵詞，如「商品查詢Demo」。
- 應用類型：可選擇「測試應用」（僅限沙箱）或「正式應用」。
- 應用描述：簡要說明用途、功能範圍。
- 回調地址：OAuth2授權或訊息通知所使用的伺服器地址。
提交後，正式應用需簽署協議並上傳補充資料；測試應用可立即使用沙箱能力。

2. 選擇接口權限

在應用詳情頁面，切換到「接口權限管理」，勾選當前業務場景所需的 API 接口。例如，要查詢商品資訊，需勾選 jingdong.sku.get、jingdong.search.sku.query 等。

注意事項：
權限勾選越多，審核時間可能越長，建議按需選擇，後續若有新需求可隨時增補。

3. 獲取 AppKey & AppSecret

權限審核通過後，可以在「應用管理」頁面中查看到：

App Key：應用標識，需用於 API 請求中。
App Secret：密鑰，用於生成請求簽名以確保安全。

重要提醒：請妥善保管 AppKey 與 AppSecret，避免洩露給未授權人員，以防止資安風險。

四、接口測試與調試

當擁有了 AppKey、AppSecret 後，即可開始與京東開放平台進行對接。建議初期先在沙箱環境充分測試，確保流程正確後再切換至正式環境。

1. 沙箱 vs 正式環境

環境	域名	說明
沙箱環境	https://sandbox-api.jd.com/routerjson	測試用，部分數據為模擬
正式環境	https://api.jd.com/routerjson	真實業務場景

沙箱環境支援大多數接口測試，並且避免對正式業務數據造成影響，非常適合用於開發初期和錯誤排查。

2. 調用示例

以商品詳情查詢（jingdong.sku.get）為例，展示最簡單的請求方式：

GET https://sandbox-api.jd.com/routerjson
?method=jingdong.sku.get
&app_key=YOUR_APP_KEY
&access_token=YOUR_ACCESS_TOKEN
&360buy_param_json={"skuId":123456789}
&timestamp=2025-04-27 14:30:00
&v=2.0
&sign=GENERATED_SIGNATURE

參數說明：

method：接口名稱
app_key：你的 AppKey
access_token：OAuth2授權後獲得的存取令牌
360buy_param_json：業務參數，以 JSON 字串形式傳遞
timestamp：時間戳，格式為 yyyy-MM-dd HH:mm:ss
v：API版本號，一般為2.0
sign：簽名，用於確保請求安全（簽名算法詳見後續文章）

範例回應：

{
"jingdong_sku_get_responce": {
"code": 0,
"msg": "success",
"skuInfo": {
"skuId": 123456789,
"skuName": "京東自營示例商品",
"price": 99.00,
"stock": 1000
}
}
}

3. 常見錯誤與排查

錯誤碼	含義	排查建議
400	參數格式錯誤或必填參數缺失	檢查 JSON 格式、參數名稱及必填項
401	簽名錯誤或未授權	確認 AppKey/AppSecret、簽名演算法
403	權限不足或調用次數超限	在應用中添加接口權限，或適當控制調用頻率
500	平台內部錯誤	稍後重試或聯繫京東技術支持

五、總結

京東開放平台為開發者提供了豐富且完善的電商能力，涵蓋了商品管理、交易處理、物流倉儲及行銷推廣等各大業務板塊。通過正確的帳號註冊、應用創建、接口權限配置及API測試流程，無論是個人開發者還是企業團隊，都能夠快速接入京東強大的生態體系，拓展業務邊界，挖掘更多潛在機會。未來，隨著平台持續升級，開發者也將享有更加豐富多樣的創新可能。

如您需要方便快速使用 Jingdong API 可聯係我們：support@luckdata.com