Trip

TRIP / API V1

落ち着いて役立つ旅行自動化を作る

旅行ツール、連携、AI エージェントのための明快な所有者限定 API です。読み取りから始め、計画を確認してから書き込みを追加します。

OpenAPI を見る始めるAPI トークンを管理

認証

個人アクセストークンは一度だけ表示し、Authorization ヘッダーだけで送信します。URL にトークンを置かないでください。

Authorization: Bearer trip_pat_…

最小限の権限

作業に必要な最小の scope だけを使います。すべてのリソースはトークン所有者の旅行に限定されます。

trips:read · trips:write · token:inspect

エージェント向け

決定的な JSON、安定したエラーコード、ページネーション、冪等な書き込み、OpenAPI で計画と確認を予測可能にします。

2 分で始める

設定でトークンを作成し、サーバー専用の secret store に保存してから、最初の旅行リクエスト前に introspection を呼び出します。

curl https://trip.gumyo.net/api/v1/trips \
  -H 'Authorization: Bearer trip_pat_REDACTED'

安全な初期設定

まず読み取ります。削除や全置換は変更内容を要約して確認を求めます。新しい変更には新しい冪等キー、再試行には同じキーを使います。

予測できる制限

標準のトークン別制限は 1 分あたり読み取り 60 回・書き込み 20 回です。rate-limit ヘッダーを守り、429 ではバックオフします。