PSI 开放 API 接口文档与第三方集成
API 概述
PSI 提供 RESTful API 接口，支持与电商平台、财务软件、物流系统等第三方系统对接。所有接口统一返回 JSON 格式数据，采用 HTTPS 加密传输。
认证方式
接口调用需先获取 Access Token，通过 HTTP Header 传递：
POST /api/auth/token
Content-Type: application/json
{
"appId": "your-app-id",
"appSecret": "your-app-secret"
}
// 响应
{
"token": "eyJhbGciOiJIUzI1NiIs...",
"expiresIn": 7200
}后续请求在 Header 中携带：Authorization: Bearer {token}
核心接口列表
| 接口 | 方法 | 说明 |
|---|---|---|
| /api/products | GET | 查询商品列表 |
| /api/products/{id} | GET | 查询商品详情 |
| /api/products | POST | 新增商品 |
| /api/purchase-orders | GET/POST | 采购单查询/创建 |
| /api/sale-orders | GET/POST | 销售单查询/创建 |
| /api/stock/query | GET | 实时库存查询 |
| /api/stock/in | POST | 入库操作 |
| /api/stock/out | POST | 出库操作 |
| /api/customers | GET/POST | 客户资料管理 |
| /api/suppliers | GET/POST | 供应商资料管理 |
请求示例：创建销售单
POST /api/sale-orders
Authorization: Bearer {token}
Content-Type: application/json
{
"customerId": "C2025001",
"orderDate": "2025-05-19",
"items": [
{
"productId": "P10086",
"quantity": 10,
"unitPrice": 128.00
},
{
"productId": "P10087",
"quantity": 5,
"unitPrice": 256.00
}
],
"remark": "客户加急订单"
}分页与筛选
列表接口支持标准分页参数：
GET /api/sale-orders?page=1&pageSize=20&startDate=2025-05-01&status=completed响应包含分页信息：
{
"data": [...],
"pagination": {
"page": 1,
"pageSize": 20,
"total": 156,
"totalPages": 8
}
}错误码说明
| 错误码 | 说明 |
|---|---|
| 400 | 请求参数错误 |
| 401 | 未授权或 Token 过期 |
| 403 | 权限不足 |
| 404 | 资源不存在 |
| 409 | 数据冲突（如库存不足） |
| 429 | 请求频率超限 |
| 500 | 服务器内部错误 |
Webhook 通知
PSI 支持配置 Webhook URL，在关键事件发生时主动推送通知：
- 订单状态变更
- 库存低于预警值
- 采购单到货确认
总结
PSI API 设计遵循 RESTful 规范，接口清晰、文档完善。通过 API 可实现与主流电商、财务、物流平台的无缝对接，构建完整的企业数字化链路。