开发者与集成中心

API 快速接入指南

欢迎使用 JavaMall 开放平台。本节将指导您如何获取 API Key 并完成首次接口调用。

1. 鉴权机制

JavaMall API 采用 API Key 与 JWT (JSON Web Token) 相结合的鉴权方式。所有请求必须在 Header 中携带有效的 Token。

2. 获取 Access Token

通过以下接口获取访问令牌，有效期为 2 小时：

curl -X POST https://api.yoursite.com/api/v1/auth/token \
-H "Content-Type: application/json" \
-d '{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET"
}'

3. 调用业务接口

获得 Token 后，在请求头中加入 Authorization 字段即可调用业务 API。

# 获取商品详情示例
curl -X GET https://api.yoursite.com/api/v1/products/12345 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

4. SDK 支持

为了提升开发效率，我们提供了多种语言的 SDK，帮助您快速集成：

• Java SDK (Maven 依赖)
• PHP Composer Package
• Node.js NPM Module