# API FAQ
SUMMARY: API に関するよくある質問 — 認証、レート制限、エラー処理、エンドポイント探索。

API FAQ
Synapse API に関するよくある質問です。
認証はどうすればよいですか？
2 つの方法があります。
1. Mind Key（データエンドポイント用）：
2. JWT（アカウントエンドポイント用）：
またはクエリパラメータ経由（60 回/分の制限あり）：
Authentication を参照。
Mind Key と JWT の違いは何ですか？
- Mind Key：テナントスコープ、期限切れなし、メモリ/チャット/タスクデータ用
- JWT：ユーザースコープ、7 日間の有効期限、アカウント/mind 管理用
Mind Key vs JWT を参照。
401 Unauthorized が出るのはなぜですか？
よくある原因：
1.  ヘッダーの欠落
2. 無効な Mind Key（ で始まるか確認）
3. Mind Key が必要な場所で JWT を使用（またはその逆）
4. Mind Key が失効している
対策： トークンを確認してください。Authentication を参照。
404 Not Found が出るのはなぜですか？
誤ったエンドポイントパスを使用しています。Synapse には  にリストされたパスのみが存在します。
対策：  を呼び出して有効なパスをすべて確認してください。推測しないでください。
429 Too Many Requests が出るのはなぜですか？
 クエリパラメータ認証を使用しており、60 回/分にレート制限されています。
対策：  ヘッダーに切り替えてください（レート制限なし）。
Rate Limits を参照。
すべてのエンドポイントを一覧表示するには？
[CODE BLOCK]
適切なエンドポイントを見つけるには？
1.  で機械可読リストを確認
2.  で完全な API ドキュメントを確認
3.  でドキュメントシステムを参照
4.  で OpenAPI 3.0 仕様を使用
POST の代わりに GET を使用できますか？
一部の POST エンドポイントには、URL 単体のツール向けに GET 版があります。
-  ↔ 
-  ↔ 
-  ↔ 
 で利用可能な GET バリアントを確認してください。
エラーはどう処理すればよいですか？
すべてのエラーは JSON を返します。
[CODE BLOCK]
Errors & Error Handling を参照。
リクエストボディの上限は？
10 MB です。それ以上のペイロード（ファイルアップロードなど）には multipart エンドポイントを使用してください。
API は CORS をサポートしていますか？
はい。全エンドポイントが以下を返します。
[CODE BLOCK]
SDK はありますか？
はい。
- Node.js：
- MCP：
詳しくは API Overview を参照。
ページネーションはどうすればよいですか？
 と  を使用します。
[CODE BLOCK]
デフォルト limit：100。最大：500。
カテゴリやタグでメモリをフィルタできますか？
はい。
[CODE BLOCK]
メモリを検索するには？
2 つの方法があります。
1. FTS5 キーワード検索：
2. セマンティック検索：
FTS5 Search と Semantic Search を参照。
メモリを更新するには？
同じ  +  で  を呼び出すと、既存メモリが重複ではなく更新されます。
[CODE BLOCK]
メモリを削除するには？
[CODE BLOCK]
一括削除はできますか？
はい。
[CODE BLOCK]
次のステップ
- API Overview
- Errors & Error Handling
- Authentication