{"title":"Rate Limits & Quotas","slug":"rate-limits","category":"api","summary":"นโยบาย rate limit สำหรับ Synapse API — Bearer header (ไม่จำกัด), ?key= (60/นาที), public endpoint","audience":["human","llm"],"tags":["api","rate-limits","quotas","throttling"],"difficulty":"beginner","updated":"2026-06-27","word_count":237,"read_minutes":1,"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":"th","translated":true,"requested_lang":"th","content_markdown":"\n# Rate Limits & Quotas\n\nSynapse มีนโยบาย rate limit ที่เรียบง่ายและคาดเดาได้ ออกแบบเพื่อป้องกันการใช้งานในทางที่ผิดโดยไม่ขัดขวางการใช้งานที่ชอบด้วย\n\n## นโยบาย Rate Limit\n\n| วิธี Auth | Limit | Scope |\n|-------------|-------|-------|\n| Mind Key (`Authorization: Bearer`) | **None** | Per-mind |\n| Mind Key (`?key=`) | 60 req/min | Per-IP |\n| JWT (`Authorization: Bearer`) | **None** | Per-user |\n| Public endpoints | **None** | Global |\n\n> [!TIP]\n> **ใช้ `Authorization: Bearer` header เสมอเมื่อทำได้** ไม่มี rate limit ใช้ `?key=` เฉพาะเครื่องมือที่ตั้ง custom header ไม่ได้\n\n## Rate Limit Headers\n\nเมื่อคุณใช้ auth ผ่าน `?key=` response จะมี rate limit headers:\n\n```\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 42\nX-RateLimit-Reset: 1782567840\n```\n\nเมื่อคุณเกิน limit:\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## เมื่อคุณกระทบ Rate Limit\n\nหากคุณได้ 429:\n\n1. **เปลี่ยนไปใช้ Authorization header** (แนะนำ):\n ```bash\n # Don't: ?key=YOUR_MIND_KEY (60/min limit)\n curl \".../memory/recall?key=YOUR_MIND_KEY\"\n \n # Do: Authorization header (unlimited)\n curl -H \"Authorization: Bearer YOUR_MIND_KEY\" .../memory/recall\n ```\n\n2. **หรือรอ `Retry-After` วินาที** แล้ว retry\n\n## ทำไมถึงมี Limit ของ ?key=\n\n`?key=` query parameter สะดวกสำหรับเครื่องมือ URL-only (browser, คำสั่ง `open`) แต่มีผลกระทบด้านความปลอดภัยและประสิทธิภาพ:\n\n- **ความปลอดภัย:** query parameter ถูกบันทึกใน server access log, browser history และ Referer header การจำกัดการใช้งานช่วยลดการสัมผัส\n- **ประสิทธิภาพ:** auth ผ่าน query parameter ต้องการ rate limiter ที่ใช้ IP (Redis lookup ต่อ request) ซึ่งเพิ่ม latency auth ผ่าน header ข้ามสิ่งนี้ไป\n- **การป้องกันการใช้งานในทางที่ผิด:** URL `?key=` ที่รั่วไหลอาจถูกแชร์และถูก hammer limit ต่อ IP จำกัดผลกระทบ\n\n## รูปแบบที่แนะนำ\n\n### LLM agent\n\n```python\n# Always use header auth\nheaders = {\"Authorization\": f\"Bearer {MIND_KEY}\"}\nresponse = requests.get(f\"{URL}/memory/recall\", headers=headers)\n```\n\n### เครื่องมือแบบ Browser\n\nหากเครื่องมือของคุณเปิด URL ได้อย่างเดียว:\n\n```bash\n# OK for occasional use (under 60/min)\nopen \"https://synapse.schaefer.zone/memory/recall?key=YOUR_MIND_KEY\"\n\n# For frequent use, switch to a tool that supports headers\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" .../memory/recall\n```\n\n### MCP server\n\nMCP server ใช้ header auth เสมอผ่าน env var `SYNAPSE_MIND_KEY` — ไม่มี rate limit\n\n### การนำเข้าแบบ bulk\n\nสำหรับการดำเนินการแบบ bulk (เช่น นำเข้า memory 1000 รายการ) ให้ใช้ header auth เสมอ การนำเข้าแบบ bulk ผ่าน `?key=` จะกระทบ rate limit ภายใน 1 นาที\n\n## Quotas (ระดับ Mind)\n\nปัจจุบันไม่มี quota ต่อ mind สำหรับขนาด storage หรือจำนวน memory limit ทั้งหมดอยู่ในระดับ auth/IP ไม่ใช่ในระดับข้อมูล อาจเปลี่ยนแปลงในอนาคตเพื่อความเป็นธรรมใน multi-tenant\n\n## การตรวจสอบการใช้งานของคุณ\n\n```bash\n# Check your current rate limit status (with ?key= auth)\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## ขั้นตอนถัดไป\n\n- [Authentication](/docs/getting-started/authentication)\n- [Errors & Error Handling](/docs/api/errors)\n","content_html":"

Rate Limits & Quotas

\n

Synapse มีนโยบาย rate limit ที่เรียบง่ายและคาดเดาได้ ออกแบบเพื่อป้องกันการใช้งานในทางที่ผิดโดยไม่ขัดขวางการใช้งานที่ชอบด้วย

\n

นโยบาย 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
วิธี AuthLimitScope
Mind Key (Authorization: Bearer)NonePer-mind
Mind Key (?key=)60 req/minPer-IP
JWT (Authorization: Bearer)NonePer-user
Public endpointsNoneGlobal
\n
**ใช้ `Authorization: Bearer` header เสมอเมื่อทำได้** ไม่มี rate limit ใช้ `?key=` เฉพาะเครื่องมือที่ตั้ง custom header ไม่ได้

Rate Limit Headers

\n

เมื่อคุณใช้ auth ผ่าน ?key= response จะมี rate limit headers:

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

เมื่อคุณเกิน limit:

\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}

เมื่อคุณกระทบ Rate Limit

\n

หากคุณได้ 429:

\n
    \n

  1. เปลี่ยนไปใช้ Authorization header (แนะนำ):

    \n
    # Don't: ?key=YOUR_MIND_KEY (60/min limit)\ncurl ".../memory/recall?key=YOUR_MIND_KEY"\n\n# Do: Authorization header (unlimited)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" .../memory/recall
    2. \n

  2. หรือรอ Retry-After วินาที แล้ว retry

    \n
    3. \n
\n

ทำไมถึงมี Limit ของ ?key=

\n

?key= query parameter สะดวกสำหรับเครื่องมือ URL-only (browser, คำสั่ง open) แต่มีผลกระทบด้านความปลอดภัยและประสิทธิภาพ:

\n\n

รูปแบบที่แนะนำ

\n

LLM agent

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

เครื่องมือแบบ Browser

\n

หากเครื่องมือของคุณเปิด URL ได้อย่างเดียว:

\n
# OK for occasional use (under 60/min)\nopen "https://synapse.schaefer.zone/memory/recall?key=YOUR_MIND_KEY"\n\n# For frequent use, switch to a tool that supports headers\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" .../memory/recall

MCP server

\n

MCP server ใช้ header auth เสมอผ่าน env var SYNAPSE_MIND_KEY — ไม่มี rate limit

\n

การนำเข้าแบบ bulk

\n

สำหรับการดำเนินการแบบ bulk (เช่น นำเข้า memory 1000 รายการ) ให้ใช้ header auth เสมอ การนำเข้าแบบ bulk ผ่าน ?key= จะกระทบ rate limit ภายใน 1 นาที

\n

Quotas (ระดับ Mind)

\n

ปัจจุบันไม่มี quota ต่อ mind สำหรับขนาด storage หรือจำนวน memory limit ทั้งหมดอยู่ในระดับ auth/IP ไม่ใช่ในระดับข้อมูล อาจเปลี่ยนแปลงในอนาคตเพื่อความเป็นธรรมใน multi-tenant

\n

การตรวจสอบการใช้งานของคุณ

\n
# Check your current rate limit status (with ?key= auth)\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","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"]}