# API 概要 & ベース URL
SUMMARY: Synapse API の全エンドポイント、ベース URL、認証パターン、レスポンス形式を一覧でご紹介します。

KEY CONTEXT:
Base URL: https://synapse.schaefer.zone
Auth: Authorization: Bearer YOUR_MIND_KEY (header, no rate limit)
      OR ?key=YOUR_MIND_KEY (query, 60 req/min)
All responses are JSON except /memory/recall (text/plain) and /docs (HTML/text/json)
All 404 responses mean the path does not exist — do NOT guess paths.
GET /endpoints returns machine-readable list of all valid endpoints.

API 概要 & ベース URL
Synapse API は RESTful な HTTP API です。特記のない限り、すべてのエンドポイントは JSON を返します。本ページでは、各エンドポイントの詳細に入る前に知っておくべき基本事項を説明します。
ベース URL
[CODE BLOCK]
本ドキュメント内のすべてのパスは、このベース URL に対する相対パスです。セルフホスト環境の場合は、ご自身の URL に置き換えてください。
認証
2 種類の方法があり、いずれも  ヘッダーで送信します。
[CODE BLOCK]
またはクエリパラメータで送信することも可能です（60 回/分にレート制限されます）。
[CODE BLOCK]
詳しくは Authentication を参照してください。
エンドポイントグループ
| グループ | 認証 | 説明 |
|-------|------|-------------|
| Public | なし | ランディングページ、ヘルスチェック、OpenAPI、ドキュメント |
| Memory | Mind Key | CRUD、検索、同期、埋め込み |
| Chat | Mind Key / JWT | 人間とエージェント間の非同期メッセージング |
| Tasks | Mind Key | タスク管理 |
| Scripts | Mind Key / JWT | 永続スクリプトストア |
| Scheduler | Mind Key | Cron ジョブ + 変数 |
| Webhooks | Mind Key | イベント時の HTTP コールバック |
| Computers | Mind Key / JWT | リモートコンピュータ制御 |
| User/Minds | JWT | アカウント + mind 管理 |
| Sharing | JWT | ユーザー間の mind 共有 |
| Push | JWT | Web Push サブスクリプション |
| Tools | なし | 時刻、電卓、乱数（パブリックユーティリティ） |
レスポンス形式
- JSON（デフォルト）：
- プレーンテキスト： は LLM 向けに最適化されたテキストを返します
- HTML：、、、、
標準レスポンスエンベロープ
成功時のレスポンスはデータを直接返します。
[CODE BLOCK]
エラー時のレスポンスは以下の形式を使用します。
[CODE BLOCK]
> [!NOTE]
>  フィールドは、よくあるエラーに関するドキュメントへのリンクを提供します。
HTTP ステータスコード
| コード | 意味 |
|------|---------|
| 200 | 成功（GET、PUT） |
| 201 | 作成済み（POST） |
| 204 | コンテンツなし（DELETE） |
| 400 | 不正なリクエスト（バリデーションエラー） |
| 401 | 認証エラー（トークン missing/invalid） |
| 403 | 禁止（トークン種別の不一致） |
| 404 | 見つからない（パスが存在しない） |
| 409 | 競合（重複） |
| 429 | リクエスト過多（レート制限） |
| 500 | サーバーエラー |
探索用エンドポイント
| エンドポイント | 目的 |
|----------|---------|
|  | ランディングページ（LLM 向け最適化） |
|  | すべてのエンドポイントの機械可読リスト |
|  | プレーンテキスト形式のエンドポイントリスト |
|  | OpenAPI 3.0 仕様 |
|  | 完全な API ドキュメント（HTML） |
|  | JSON 形式の API ドキュメント |
|  | ドキュメントシステム（HTML） |
|  | ドキュメントインデックス（JSON） |
|  | すべてのドキュメントを 1 つのテキストブロックで |
|  | インタラクティブな API プレイグラウンド |
レート制限
| 認証方法 | 制限 |
|-------------|-------|
| Mind Key（ヘッダー） | なし |
| Mind Key（?key=） | 60 回/分（IP ごと） |
| JWT（ヘッダー） | なし |
| パブリックエンドポイント | なし |
レート制限対象のレスポンスには以下が含まれます。
[CODE BLOCK]
ページネーション
リストエンドポイントは  と  をサポートしています。
[CODE BLOCK]
デフォルトの limit：100。最大 limit：500。
CORS
すべてのエンドポイントはブラウザベースのクライアント向けに CORS をサポートしています。
[CODE BLOCK]
SDK & クライアント
- Node.js SDK：（リポジトリ）
- MCP Server：（リポジトリ）
- HTTP クライアント：任意の HTTP ライブラリ（curl、fetch、axios など）
次のステップ
- Memory API — 最も重要なエンドポイント
- Chat API — 人間とエージェント間の非同期通信
- Errors & Error Handling