Complete Guide to Accessing the JD Open Platform (JOS)

Introduction

In today’s rapidly evolving e-commerce landscape, open platforms have become crucial tools for major companies to connect with partners and expand their ecosystems. The JD Open Platform (Jingdong Open Platform, JOS) serves as JD.com's all-in-one service offering e-commerce capabilities to developers, ISVs, and partners. Through JOS, you can access product information, manage orders, synchronize inventory, dispatch logistics, and even execute marketing campaigns—covering almost all core aspects of an e-commerce system. It acts as an indispensable bridge to JD’s vast ecosystem.

1. Platform Overview

1.1 What is JD Open Platform?

The JD Open Platform (Jingdong Open Platform, JOS) is an e-commerce capability service launched by JD.com, targeting third-party developers. It covers multiple modules, including product management, order transactions, warehousing and logistics, and marketing promotion. Since its launch in 2012, it has supported access for individuals, enterprises, and ISVs, helping partners quickly build applications that integrate with JD’s ecosystem.

Core Capability Modules

• Product Management

  • Product search and status control (shelving/unshelving)

  • Inventory synchronization and price updates

• Orders and Transactions

  • Order creation, query, and cancellation

  • Refund applications and after-sales work order management

• Warehousing and Logistics

  • JD Express ("second delivery") service and cloud warehouse integration

  • Freight calculation and logistics tracking

• Marketing and Promotion

  • JingZhunTong ad placement

  • JD Alliance affiliate product promotions

By leveraging these capabilities, developers can quickly build solutions such as brand official sites, distribution systems, ERP integrations, and data analytics platforms, achieving business growth and operational efficiency.

2. Developer Account Registration

Before you can call any API, you must first complete developer identity registration and authentication. JD Open Platform supports three major types of developer identities: individual developers, enterprise developers, and ISV service providers, each designed for different access needs.

Registration Process

1. Access the Portal
   Open a browser and visit the JD Open Platform homepage, then log in with your JD account.

2. Choose Account Type
   After logging in, click "Become a Developer" at the top right, choose the appropriate account type (individual or enterprise), and fill in the required qualification information.

3. Identity Verification

   • Individual: Upload an ID photo and complete facial recognition.

   • Enterprise: Submit a scanned copy of the business license, company bylaws, and corporate bank account information.

4. Waiting for Review
   JD will complete the review within 1–3 business days. Once approved, you will see your activated developer account in the "Developer Center."

Pro Tip:
If you register as an individual, you can initially use the sandbox environment for learning and testing. However, to call official APIs, list applications in the "App Store," or use advanced services, you must upgrade to an enterprise or ISV identity and pass full qualification review.

3. Creating Applications and Obtaining API Keys

Once your account is activated, the next step is to create an application (Application), configure the necessary permissions within the app, and obtain the credentials (AppKey & AppSecret) needed for API calls.

3.1 Creating a New Application

1. In the "Developer Center" sidebar, navigate to "My Applications" → "Create New Application."

2. Fill in basic application information:

   • Application Name: It’s recommended to include business scenario keywords, such as "Product Query Demo."

   • Application Type: Choose between "Test Application" (sandbox only) or "Official Application."

   • Application Description: Briefly describe the purpose and functional scope.

   • Callback Address: Required for OAuth2 authorization or message notifications.

3. After submission, official applications require signing an agreement and uploading additional documents; test applications can use sandbox features immediately.

3.2 Selecting API Permissions

In the application details page, switch to the "Interface Permission Management" section and select the API interfaces needed for your business scenario.
For example, to query product information, you need to select jingdong.sku.get, jingdong.search.sku.query, etc.

Note:
The more permissions you request, the longer the approval process may take. It’s recommended to request only necessary permissions at first, and add more later as needed.

3.3 Obtaining AppKey & AppSecret

Once your permissions are approved, you will see the following in the "Application Management" page:

• App Key: Identifies your application and is used in API request parameters.

• App Secret: A secret key used to generate request signatures to ensure call security.

Important Reminder:
Keep your AppKey and AppSecret safe. Do not disclose them to unauthorized individuals to avoid security risks.

4. Interface Testing and Debugging

After obtaining the AppKey and AppSecret, you can start interacting with JD’s Open Platform. It is highly recommended to first conduct thorough testing in the sandbox environment before switching to the official production environment.

4.1 Sandbox vs. Production Environments

The sandbox environment supports most API testing scenarios and prevents interference with live business data, making it ideal for development and troubleshooting.

4.2 API Call Example

Here’s a basic example for Product Detail Query (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

Parameter Descriptions:

• method: API interface name

• app_key: Your AppKey

• access_token: Token obtained through OAuth2 authorization

• 360buy_param_json: Business parameters, passed as a JSON string

• timestamp: Time stamp in yyyy-MM-dd HH:mm:ss format

• v: API version, generally 2.0

• sign: Signature to ensure request security (detailed in a future article)

Sample Response:

{
"jingdong_sku_get_responce": {
"code": 0,
"msg": "success",
"skuInfo": {
"skuId": 123456789,
"skuName": "JD Self-Operated Example Product",
"price": 99.00,
"stock": 1000
}
}
}

4.3 Common Errors and Troubleshooting

5. Conclusion

The JD Open Platform provides developers with comprehensive and powerful e-commerce capabilities, covering key business areas such as product management, transaction processing, logistics and warehousing, and marketing.
By correctly registering your account, creating applications, configuring interface permissions, and following structured API testing procedures, both individual developers and enterprise teams can rapidly integrate with JD’s robust ecosystem, expanding business boundaries and unlocking new opportunities.
As the platform continues to evolve, developers will gain access to even more diverse and innovative possibilities.

For seamless and efficient access to the Jingdong API, please contact our team : support@luckdata.com