API v1.0 - 安定版

API ドキュメント

Seisei APIを使用して、POS・会計・在庫管理システムを
あなたのアプリケーションに統合できます

99.9%
API稼働率
<100ms
平均応答時間
50+
エンドポイント
6
公式SDK

クイックスタート

1

APIキーを取得

ダッシュボードから開発者設定にアクセスし、APIキーを生成します。

APIキーを申請 →
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を統合できます

🟨

JavaScript / Node.js

バージョン: v2.1.0

ドキュメントを見る →
🐍

Python

バージョン: v2.0.3

ドキュメントを見る →
🐘

PHP

バージョン: v1.8.2

ドキュメントを見る →
💎

Ruby

バージョン: v1.5.0

ドキュメントを見る →
🔵

Go

バージョン: v1.3.1

ドキュメントを見る →

Java

バージョン: v1.4.0

ドキュメントを見る →

エラーコード

コード名前説明
400Bad Requestリクエストの形式が不正です
401Unauthorized認証に失敗しました
403Forbiddenアクセス権限がありません
404Not Foundリソースが見つかりません
429Rate Limitedリクエスト制限を超えました
500Server Errorサーバーエラーが発生しました

レート制限

標準プラン

  • • 1,000 リクエスト/分
  • • 100,000 リクエスト/日
  • • 同時接続数: 10

エンタープライズプラン

  • • 10,000 リクエスト/分
  • • 無制限 リクエスト/日
  • • 同時接続数: 無制限

💡 レート制限に達した場合、429 Too Many Requests エラーが返されます。Retry-After ヘッダーを確認して、再試行までの待機時間を取得してください。

今すぐ開発を始めましょう

無料のサンドボックス環境でAPIをテストできます。
本番環境への移行も簡単です。

無料で始める見積作成