99.9%
API稼働率
<100ms
平均応答時間
50+
エンドポイント
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');
});公式SDK
お好みの言語でSeiseiを統合できます
エラーコード
| コード | 名前 | 説明 |
|---|---|---|
| 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 ヘッダーを確認して、再試行までの待機時間を取得してください。