APIリファレンス

内部APIリファレンス

これらのエンドポイントは、IVGraphのWebアプリケーションで使用されています。特に記載がない限り、JWT認証が必要です。ここでは参照用に掲載しています。インテグレーション用途には、V1 LLM APIの利用を推奨します。

ユーザーとプロフィール

メソッド エンドポイント 説明
GET /api/auth/me/ 現在のユーザー情報（id, email, username, is_staff）を取得します
GET /api/auth/validate/ JWTトークンが有効か確認します
POST /api/auth/refresh/ アクセストークンを更新します
POST /api/auth/logout/ リフレッシュトークンをブラックリストに登録します
GET /api/user/me/ ユーザープロフィールの詳細を取得します
PUT /api/user/me/ ユーザープロフィールを更新します
GET /api/user/profile/ ユーザープロフィールを表示します

紹介システム

メソッド エンドポイント 説明
GET /api/referral/my-code/ ユーザーの紹介コードを取得します
POST /api/referral/apply/ 紹介コードを適用します
GET /api/referral/stats/ 紹介に関する統計を取得します

Notion OAuth

メソッド エンドポイント 説明
GET /api/integrations/auth/notion/ NotionのOAuthフローを開始します（Notionにリダイレクトします）
GET /api/integrations/auth/notion/callback OAuthコールバックです（コードをトークンに交換します）
GET /api/integrations/auth/notion/status OAuthの接続状態を確認します
POST /api/integrations/auth/logout/ Notionインテグレーションの接続を解除します
POST /api/integrations/auth/delete-account/ ユーザーアカウントとすべてのデータを削除します

ワークスペース管理

メソッド エンドポイント 説明
GET /api/integrations/workspaces/ ユーザーのNotionワークスペース一覧を取得します
GET /api/integrations/workspaces/<id>/ ワークスペースの詳細を取得します
POST /api/integrations/workspaces/<id>/primary/ ワークスペースをメインのワークスペースに設定します

同期管理

メソッド エンドポイント 説明
GET /api/integrations/status/ インテグレーションと同期の状態を取得します
GET /api/integrations/notion/permissions/ Notion APIの権限を確認します
POST /api/integrations/airbyte/setup/ ワークスペースのAirbyte接続を設定します
GET /api/integrations/airbyte/setup/progress/ 設定の進捗を取得します
POST /api/integrations/airbyte/sync/ 差分同期を開始します
POST /api/integrations/airbyte/sync/cancel/ 実行中の同期をキャンセルします
GET /api/integrations/airbyte/sync/progress/ 同期の進捗を取得します（このエンドポイントをポーリングしてください）
POST /api/integrations/airbyte/full-refresh/ データ全体を更新します（すべてを再同期します）

請求（Stripe）

メソッド エンドポイント 説明
GET /api/billing/plans/ 利用可能なサブスクリプションプラン一覧を取得します
POST /api/billing/create-checkout/ Stripeの決済セッションを作成します
POST /api/billing/confirm-checkout/ 決済の完了を確認します
GET /api/billing/subscription/ ユーザーのサブスクリプション詳細を取得します
POST /api/billing/portal/ Stripeのカスタマーポータルへのリンクを作成します

スタイルルールとグラフ設定

メソッド エンドポイント 説明
GET /api/databases/ ルールの適用対象となるデータベース一覧を取得します
GET/PUT /api/graph-settings/ グラフ全体の設定（色、切り替え項目）を取得・更新します
GET/POST /api/advanced-rules/ 高度なスタイルルールの一覧取得・作成を行います
GET/PUT/DELETE /api/advanced-rules/<id>/ 個別のルールを管理します
POST /api/advanced-rules/reorder/ 優先度に従ってルールを並べ替えます
GET/POST /api/style-presets/ スタイルプリセットの一覧取得・作成を行います
GET/PUT/DELETE /api/style-presets/<id>/ 個別のプリセットを管理します
POST /api/style-presets/<id>/activate/ プリセットを有効にします
POST /api/style-presets/<id>/duplicate/ プリセットを複製します

サービストークン管理

メソッド エンドポイント 説明
GET /api/tokens/ ユーザーのサービストークン一覧を取得します
POST /api/tokens/ 新しいサービストークンを作成します
DELETE /api/tokens/<id>/ トークンを永久に失効させます

トークンの作成について詳しくは、認証をご覧ください。

その他

メソッド エンドポイント 認証 説明
GET /api/connections/ JWT ユーザーのAirbyte接続一覧を取得します
GET /api/integrations/ JWT インテグレーションの概要を取得します
GET /api/activity/ JWT 最近のアクティビティログを取得します
GET /api/health/ なし 稼働状態を確認します
GET /api/health/celery/ なし Celeryワーカーの稼働状態を確認します
GET /api/stats/public/ なし プラットフォームの統計を取得します（24時間キャッシュ）
POST /api/errors/report/ なし フロントエンドのエラーを報告します