Sixto API：チームと同じ操作と権限
Sixto API はタスク、記録、レポート、メッセージなど、アプリと同じ操作を公開します。キーには指定した権限だけが与えられます。各呼び出しはキーの操作履歴に記録されます。キーは自分の身元と許可された操作を確認できます。重要な操作は担当者の確認を待ちます。
利用可能。権限を限定したキーを使うバージョン付き REST API で、予約、宿泊者、タスク、財務、チェックイン、ロック、チャネルなどを扱えます。
自分のツールに限定したアクセス権
API キーに付与されるのは選択した権限だけ
できること
送受信するデータと、送信しないデータを把握
矢印は Sixto を基準としたデータの流れる方向を示します。
幅広い機能
タスク、予約、宿泊者、レビュー、メッセージ、チェックイン、法令対応、ロック、チャネル、電子請求書、銀行と帳簿、市場ベンチマーク、検索、設定。
共通の権限一覧から限定したキーを作成
キーには担当者と同じ権限一覧を使います。権限を変更するには、オーナーが新しいキーを作成して古いキーを失効させます。失効は次の呼び出しから有効です。
自身の権限を確認できる
API に身元と許可された操作を問い合わせます（whoami と capabilities）。各経路で必要な権限も確認できます。
安全な再試行と操作履歴
各書き込み操作には external_id や Idempotency-Key ヘッダーなど、再試行を識別する方法が記載されています。同じ識別子を異なる内容で再利用すると 409 が返されます。すべてのリクエストに ID があり、操作履歴に表示されます。
公平な制限
各キーには独立した利用枠があり、既定では一分間に 600 リクエストです。一つのキーの大量利用がほかのキーを遅くしません。GET /api/v1/capabilities で現在の値を確認できます。
AI アプリを使うなら MCP
Sixto は REST API に加え、OAuth でログインする AI アプリ向け MCP サーバーを提供しています。組織のオーナーまたはマネージャーが有効にするまで無効です。公開の読み取り専用ドキュメント MCP も利用できます。
- サーバーアドレス
https://holasixto.com/mcp- ドキュメント MCP
https://holasixto.com/mcp/docs公開の読み取り専用サービスです。Sixto のドキュメントを検索し、組織のデータには一切アクセスしません。
仕組み
- 01
オーナーが設定でキーを作成し、必要な権限を選択します。キーは一度だけ表示されます。
- 02
Bearer トークンとして送ります。whoami と capabilities を呼び出し、キーに許可された操作を確認します。
- 03
エンドポイントを通じて読み書きします。書き込みにはアプリと同じ確認が適用されます。
- 04
API の操作履歴で呼び出しを確認し、必要に応じてキーを失効させます。
同期する内容
よくある質問
開発者向けガイドはありますか？
はい。OpenAPI 3.1 の仕様書は /api/v1/openapi.json、クライアントガイドは /api/v1/guide.json にあります。各操作には x-contract-status が表示されます。complete は確認済みの仕様、unsupported は経路自体は利用できてもサポート対象のクライアント機能には含まれないことを意味します。読み取り専用の文書サーバーは /mcp/docs にあります。
キーは誰として操作しますか？
キーは組織のために、そのキー自身の権限で操作します。独自の施設一覧はなく、作成者の施設制限も引き継ぎません。Sixto が Sixto-On-Behalf-Of 委任で個人のリクエストを転送する場合は、その人の現在の施設と権限の制限も適用されます。
キーの権限はどう変更しますか？
希望する権限で新しいキーを作成し、ツールを切り替えてから古いキーを失効させます。既存のキーは編集できません。失効したキーは次の呼び出しで拒否されます。
422 と 429 は何を意味しますか？
422 は入力の検証失敗です。フィールドごとの errors オブジェクトを読み、入力を直して再送してください。429 はキーが上限に達したことを示します。Retry-After ヘッダーにある秒数を待ち、間隔を延ばしながら再試行してください。X-Request-Id を控えると操作履歴で呼び出しを探せます。
キーでドアを解錠できますか？
いいえ。API からの遠隔解錠は利用できません。
API にバージョンはありますか？
はい。/api/v1 以下にあります。