كل خطأ بالشكل {"error":{"code":"…","message":"…"}} ورمز ثابت آليًا. الأشكال المشتركة أدناه تسري على كل نقاط api-key؛ وأخطاء كل نقطة مذكورة في صفحتها.
shared
| الحالة | code | مثال |
|---|
| 401 | unauthorized | {"code":"unauthorized","message":"missing or invalid api key"} |
| 402 | quota_exceeded | {"code":"quota_exceeded","message":"monthly quota exceeded","upgrade_url":"/pricing"} |
| 403 | forbidden_scope | {"code":"forbidden_scope","message":"missing required scope: memory:read"} |
| 429 | rate_limited | {"code":"rate_limited","message":"rate limit exceeded"} |
POST /v1/read
| الحالة | code | مثال |
|---|
| 400 | bad_request | {"code":"bad_request","message":"invalid url"} |
| 502 | fetch_failed | {"code":"fetch_failed","message":"upstream returned 404"} |
| 504 | fetch_timeout | {"code":"fetch_timeout","message":"deadline exceeded"} |
POST /v1/search
| الحالة | code | مثال |
|---|
| 400 | bad_request | {"code":"bad_request","message":"query is required"} |
| 502 | fetch_failed | {"code":"fetch_failed","message":"all search routes failed"} |
POST /v1/research
| الحالة | code | مثال |
|---|
| 400 | bad_request | {"code":"bad_request","message":"question is required"} |
| 502 | fetch_failed | {"code":"fetch_failed","message":"all search routes failed"} |
POST /mcp
| الحالة | code | مثال |
|---|
| 401 | -32001 | {"code":-32001,"message":"invalid api key"} |
| 403 | -32003 | {"code":-32003,"message":"missing required scope: memory:write"} |
| 405 | method_not_allowed | {"code":"method_not_allowed","message":"POST only — MCP speaks JSON-RPC over POST"} |
POST /v1/memory/write
| الحالة | code | مثال |
|---|
| 400 | bad_request | {"code":"bad_request","message":"text normalizes to empty — nothing to store"} |
POST /v1/memory/search
| الحالة | code | مثال |
|---|
| 400 | bad_request | {"code":"bad_request","message":"query normalizes to empty — nothing to match"} |
DELETE /v1/memory/:id
| الحالة | code | مثال |
|---|
| 404 | not_found | {"code":"not_found","message":"memory item not found"} |
POST /auth/signup
| الحالة | code | مثال |
|---|
| 400 | bad_request | {"code":"bad_request","message":"invalid email"} |
| 409 | bad_request | {"code":"bad_request","message":"email already registered"} |
| 429 | rate_limited | {"code":"rate_limited","message":"rate limit exceeded"} |
POST /auth/login
| الحالة | code | مثال |
|---|
| 401 | unauthorized | {"code":"unauthorized","message":"invalid credentials"} |
| 429 | rate_limited | {"code":"rate_limited","message":"rate limit exceeded"} |
POST /auth/verify-email
| الحالة | code | مثال |
|---|
| 400 | bad_request | {"code":"bad_request","message":"invalid or expired token"} |
POST /auth/forgot-password
| الحالة | code | مثال |
|---|
| 429 | rate_limited | {"code":"rate_limited","message":"rate limit exceeded"} |
POST /auth/reset-password
| الحالة | code | مثال |
|---|
| 400 | bad_request | {"code":"bad_request","message":"invalid or expired token"} |
GET /me
| الحالة | code | مثال |
|---|
| 401 | unauthorized | {"code":"unauthorized","message":"login required"} |
POST /keys
| الحالة | code | مثال |
|---|
| 401 | unauthorized | {"code":"unauthorized","message":"login required"} |
| 403 | email_not_verified | {"code":"email_not_verified","message":"verify your email before creating keys"} |
| 403 | forbidden_scope | {"code":"forbidden_scope","message":"scopes outside your plan: memory:read"} |
GET /keys
| الحالة | code | مثال |
|---|
| 401 | unauthorized | {"code":"unauthorized","message":"login required"} |
DELETE /keys/:id
| الحالة | code | مثال |
|---|
| 401 | unauthorized | {"code":"unauthorized","message":"login required"} |
| 404 | not_found | {"code":"not_found","message":"key not found"} |
POST /billing/checkout
| الحالة | code | مثال |
|---|
| 401 | unauthorized | {"code":"unauthorized","message":"login required"} |
| 400 | bad_request | {"code":"bad_request","message":"unknown plan"} |
| 503 | internal | {"code":"internal","message":"billing_not_configured"} |
POST /billing/webhook
| الحالة | code | مثال |
|---|
| 400 | bad_request | {"code":"bad_request","message":"invalid webhook signature"} |