99.9%
API 可用性
<100ms
平均响应时间
50+
API 端点
6
官方 SDK
快速入门
2
配置认证
在所有 API 请求中包含 Bearer 认证头。
// API 密钥认证
const response = await fetch('https://api.seisei.tokyo/v1/orders', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
});3
执行第一个 API 调用
获取订单列表示例：
// 获取订单列表
const response = await fetch('https://api.seisei.tokyo/v1/orders?limit=10&status=completed', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
});
const orders = await response.json();
console.log(orders.data);API 端点
🛒
POS API
销售与订单管理 API
| 方法 | 端点 | 说明 |
|---|---|---|
| GET | /api/v1/orders | 获取订单列表 |
| POST | /api/v1/orders | 创建新订单 |
| GET | /api/v1/orders/{id} | 获取订单详情 |
| PUT | /api/v1/orders/{id} | 更新订单 |
| DELETE | /api/v1/orders/{id} | 取消订单 |
💰
会计 API
会计与财务处理 API
| 方法 | 端点 | 说明 |
|---|---|---|
| GET | /api/v1/invoices | 获取发票列表 |
| POST | /api/v1/invoices | 创建发票 |
| GET | /api/v1/transactions | 获取交易记录 |
| POST | /api/v1/payments | 记录付款 |
| GET | /api/v1/reports/financial | 获取财务报表 |
📦
库存 API
库存管理 API
| 方法 | 端点 | 说明 |
|---|---|---|
| GET | /api/v1/inventory | 获取库存列表 |
| PUT | /api/v1/inventory/{id} | 更新库存数量 |
| POST | /api/v1/inventory/adjust | 执行库存调整 |
| GET | /api/v1/products | 获取商品列表 |
| POST | /api/v1/products | 注册商品 |
👥
客户 API
客户管理 API
| 方法 | 端点 | 说明 |
|---|---|---|
| GET | /api/v1/customers | 获取客户列表 |
| POST | /api/v1/customers | 注册客户 |
| GET | /api/v1/customers/{id} | 获取客户详情 |
| PUT | /api/v1/customers/{id} | 更新客户信息 |
| GET | /api/v1/customers/{id}/history | 获取购买历史 |
📊
报表 API
分析与报表 API
| 方法 | 端点 | 说明 |
|---|---|---|
| GET | /api/v1/reports/sales | 获取销售报表 |
| GET | /api/v1/reports/inventory | 获取库存报表 |
| GET | /api/v1/analytics/dashboard | 仪表盘数据 |
| GET | /api/v1/analytics/trends | 趋势分析数据 |
代码示例
创建订单
// 创建新订单
const newOrder = {
customer_id: 'cus_123456',
items: [
{ product_id: 'prod_001', quantity: 2, price: 1500 },
{ product_id: 'prod_002', quantity: 1, price: 2000 }
],
payment_method: 'credit_card'
};
const response = await fetch('https://api.seisei.tokyo/v1/orders', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify(newOrder)
});处理 Webhook 事件
// 处理 Webhook 事件
app.post('/webhook', (req, res) => {
const event = req.body;
switch (event.type) {
case 'order.created':
handleNewOrder(event.data);
break;
case 'payment.completed':
handlePayment(event.data);
break;
case 'inventory.low':
handleLowInventory(event.data);
break;
}
res.status(200).send('OK');
});错误代码
| 代码 | 名称 | 说明 |
|---|---|---|
| 400 | Bad Request | 请求格式不正确 |
| 401 | Unauthorized | 认证失败 |
| 403 | Forbidden | 没有访问权限 |
| 404 | Not Found | 资源未找到 |
| 429 | Rate Limited | 请求超过限制 |
| 500 | Server Error | 服务器错误 |
速率限制
标准版
- • 1,000 请求/分钟
- • 100,000 请求/天
- • 并发连接数: 10
企业版
- • 10,000 请求/分钟
- • 无限 请求/天
- • 并发连接数: 无限
💡 达到速率限制时，将返回 429 Too Many Requests 错误。 请检查 Retry-After 头以获取重试等待时间。