{"title":"Rate Limits & Quotas","slug":"rate-limits","category":"api","summary":"Kebijakan rate limit untuk API Synapse — Bearer header (tidak terbatas), ?key= (60/menit), endpoint publik.","audience":["human","llm"],"tags":["api","rate-limits","quotas","throttling"],"difficulty":"beginner","updated":"2026-06-27","word_count":326,"read_minutes":2,"llm_context":"Mind Key (Authorization: Bearer header) → NO rate limit\nMind Key (?key= query param) → 60 req/min per IP\nJWT (Authorization: Bearer header) → NO rate limit\nPublic endpoints (/tools/*, /docs, /health, /endpoints) → NO rate limit\nRate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After\nRecommendation: ALWAYS use Authorization header. Use ?key= only for URL-only tools.\n","lang":"id","translated":true,"requested_lang":"id","content_markdown":"\n# Rate Limits & Quotas\n\nSynapse memiliki kebijakan rate limit yang sederhana dan dapat diprediksi,\ndirancang untuk mencegah penyalahgunaan tanpa menghambat penggunaan yang sah.\n\n## Kebijakan Rate Limit\n\n| Metode Auth | Batas | Cakupan |\n|-------------|-------|-------|\n| Mind Key (`Authorization: Bearer`) | **Tidak ada** | Per-mind |\n| Mind Key (`?key=`) | 60 req/menit | Per-IP |\n| JWT (`Authorization: Bearer`) | **Tidak ada** | Per-user |\n| Endpoint publik | **Tidak ada** | Global |\n\n> [!TIP]\n> **Selalu gunakan header `Authorization: Bearer`** bila memungkinkan. Header ini\n> tidak memiliki rate limit. Gunakan `?key=` hanya untuk alat yang tidak dapat\n> mengatur header khusus.\n\n## Header Rate Limit\n\nSaat Anda menggunakan autentikasi `?key=`, respons menyertakan header rate limit:\n\n```\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 42\nX-RateLimit-Reset: 1782567840\n```\n\nSaat Anda melebihi batas:\n\n```\nHTTP/1.1 429 Too Many Requests\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 0\nRetry-After: 42\nContent-Type: application/json\n\n{\n \"statusCode\": 429,\n \"error\": \"Too Many Requests\",\n \"message\": \"Rate limit exceeded. Use Authorization header for unlimited access.\"\n}\n```\n\n## Saat Anda Mengenai Rate Limit\n\nJika Anda mendapat 429:\n\n1. **Beralih ke header Authorization** (disarankan):\n ```bash\n # Jangan: ?key=YOUR_MIND_KEY (batas 60/menit)\n curl \".../memory/recall?key=YOUR_MIND_KEY\"\n \n # Lakukan: header Authorization (tidak terbatas)\n curl -H \"Authorization: Bearer YOUR_MIND_KEY\" .../memory/recall\n ```\n\n2. **Atau tunggu `Retry-After` detik** lalu coba lagi.\n\n## Mengapa Batas ?key= Ada\n\nParameter query `?key=` nyaman untuk alat yang hanya menggunakan URL (browser,\nperintah `open`), tetapi memiliki implikasi keamanan dan performa:\n\n- **Keamanan:** Parameter query dicatat dalam log akses server, riwayat\n browser, dan header Referer. Membatasi penggunaan mengurangi paparan.\n- **Performa:** Autentikasi parameter query memerlukan rate limiter berbasis IP\n (pencarian Redis per permintaan), yang menambah latensi. Autentikasi header\n melewati ini.\n- **Pencegahan penyalahgunaan:** URL `?key=` yang bocor dapat dibagikan dan\n dibombardir. Batas IP membatasi dampak.\n\n## Pola yang Disarankan\n\n### Agen LLM\n\n```python\n# Selalu gunakan autentikasi header\nheaders = {\"Authorization\": f\"Bearer {MIND_KEY}\"}\nresponse = requests.get(f\"{URL}/memory/recall\", headers=headers)\n```\n\n### Alat berbasis browser\n\nJika alat Anda hanya dapat membuka URL:\n\n```bash\n# OK untuk penggunaan sesekali (di bawah 60/menit)\nopen \"https://synapse.schaefer.zone/memory/recall?key=YOUR_MIND_KEY\"\n\n# Untuk penggunaan sering, beralih ke alat yang mendukung header\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" .../memory/recall\n```\n\n### MCP server\n\nMCP server selalu menggunakan autentikasi header melalui env var\n`SYNAPSE_MIND_KEY` — tidak ada rate limit yang berlaku.\n\n### Impor massal\n\nUntuk operasi massal (mis. mengimpor 1000 memori), selalu gunakan autentikasi\nheader. Impor massal melalui `?key=` akan mengenai rate limit dalam 1 menit.\n\n## Quota (Level Mind)\n\nSaat ini tidak ada kuota per-mind untuk ukuran penyimpanan atau jumlah memori.\nSemua batas ada di level auth/IP, bukan level data. Ini mungkin berubah di\nmasa depan untuk keadilan multi-tenant.\n\n## Memantau Penggunaan Anda\n\n```bash\n# Periksa status rate limit Anda saat ini (dengan autentikasi ?key=)\ncurl -i \"https://synapse.schaefer.zone/memory/stats?key=YOUR_MIND_KEY\" | grep -i ratelimit\n\n# Output:\n# X-RateLimit-Limit: 60\n# X-RateLimit-Remaining: 58\n# X-RateLimit-Reset: 1782567840\n```\n\n## Langkah Berikutnya\n\n- [Autentikasi](/docs/getting-started/authentication)\n- [Errors & Error Handling](/docs/api/errors)\n","content_html":"

Rate Limits & Quotas

\n

Synapse memiliki kebijakan rate limit yang sederhana dan dapat diprediksi,\ndirancang untuk mencegah penyalahgunaan tanpa menghambat penggunaan yang sah.

\n

Kebijakan Rate Limit

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Metode AuthBatasCakupan
Mind Key (Authorization: Bearer)Tidak adaPer-mind
Mind Key (?key=)60 req/menitPer-IP
JWT (Authorization: Bearer)Tidak adaPer-user
Endpoint publikTidak adaGlobal
\n
**Selalu gunakan header `Authorization: Bearer`** bila memungkinkan. Header ini\ntidak memiliki rate limit. Gunakan `?key=` hanya untuk alat yang tidak dapat\nmengatur header khusus.

Header Rate Limit

\n

Saat Anda menggunakan autentikasi ?key=, respons menyertakan header rate limit:

\n
X-RateLimit-Limit: 60\nX-RateLimit-Remaining: 42\nX-RateLimit-Reset: 1782567840

Saat Anda melebihi batas:

\n
HTTP/1.1 429 Too Many Requests\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 0\nRetry-After: 42\nContent-Type: application/json\n\n{\n  "statusCode": 429,\n  "error": "Too Many Requests",\n  "message": "Rate limit exceeded. Use Authorization header for unlimited access."\n}

Saat Anda Mengenai Rate Limit

\n

Jika Anda mendapat 429:

\n
    \n

  1. Beralih ke header Authorization (disarankan):

    \n
    # Jangan: ?key=YOUR_MIND_KEY (batas 60/menit)\ncurl ".../memory/recall?key=YOUR_MIND_KEY"\n\n# Lakukan: header Authorization (tidak terbatas)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" .../memory/recall
    2. \n

  2. Atau tunggu Retry-After detik lalu coba lagi.

    \n
    3. \n
\n

Mengapa Batas ?key= Ada

\n

Parameter query ?key= nyaman untuk alat yang hanya menggunakan URL (browser,\nperintah open), tetapi memiliki implikasi keamanan dan performa:

\n\n

Pola yang Disarankan

\n

Agen LLM

\n
# Selalu gunakan autentikasi header\nheaders = {"Authorization": f"Bearer {MIND_KEY}"}\nresponse = requests.get(f"{URL}/memory/recall", headers=headers)

Alat berbasis browser

\n

Jika alat Anda hanya dapat membuka URL:

\n
# OK untuk penggunaan sesekali (di bawah 60/menit)\nopen "https://synapse.schaefer.zone/memory/recall?key=YOUR_MIND_KEY"\n\n# Untuk penggunaan sering, beralih ke alat yang mendukung header\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" .../memory/recall

MCP server

\n

MCP server selalu menggunakan autentikasi header melalui env var\nSYNAPSE_MIND_KEY — tidak ada rate limit yang berlaku.

\n

Impor massal

\n

Untuk operasi massal (mis. mengimpor 1000 memori), selalu gunakan autentikasi\nheader. Impor massal melalui ?key= akan mengenai rate limit dalam 1 menit.

\n

Quota (Level Mind)

\n

Saat ini tidak ada kuota per-mind untuk ukuran penyimpanan atau jumlah memori.\nSemua batas ada di level auth/IP, bukan level data. Ini mungkin berubah di\nmasa depan untuk keadilan multi-tenant.

\n

Memantau Penggunaan Anda

\n
# Periksa status rate limit Anda saat ini (dengan autentikasi ?key=)\ncurl -i "https://synapse.schaefer.zone/memory/stats?key=YOUR_MIND_KEY" | grep -i ratelimit\n\n# Output:\n# X-RateLimit-Limit: 60\n# X-RateLimit-Remaining: 58\n# X-RateLimit-Reset: 1782567840

Langkah Berikutnya

\n\n","urls":{"html":"/docs/api/rate-limits","text":"/docs/api/rate-limits?format=text","json":"/docs/api/rate-limits?format=json","llm":"/docs/api/rate-limits?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}