商户平台对接接口文档

# 文档概述

本文档详细描述了电商平台与商户系统之间的接口规范，用于实现商品信息、订单数据、库存同步等功能。通过这些接口，商户可以实现以下核心功能：

1. 商品管理：上传、更新、删除商品信息
2. 库存管理：实时同步库存数据
3. 订单管理：接收订单通知、更新订单状态
4. 配送管理：管理骑手配送信息

# 接口规范

# 基本信息

• 基础URL: https://api.example.com/v1
• 数据格式: 所有接口采用JSON格式进行数据交换
• 字符编码: UTF-8
• 请求方式: 主要使用POST和GET方法
• 状态码: 遵循HTTP标准状态码

# 认证方式

所有接口均需要进行身份验证，采用OAuth 2.0授权框架。

1. 获取访问令牌

POST /oauth/token

请求参数：

响应示例：

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 7200
}

2. 使用访问令牌

在所有API请求的Header中添加：

Authorization: Bearer {access_token}

# 通用响应格式

{
  "code": 200,           // 状态码，200表示成功
  "message": "success",  // 状态描述
  "data": {              // 响应数据
    // 具体数据内容
  },
  "timestamp": 1623123456789  // 时间戳
}

# 错误码说明