Límits de peticions
Com Feedjolt limita l'API REST i el servidor MCP, quines capçaleres enviem i com tractar un 429.
Feedjolt limita per clau API si n'hi ha, si no per IP. Els límits són per ruta (enllaç màgic, formulari de contacte i escriptures públiques són més estrictes que les lectures). Els números poden canviar; fia't de les capçaleres de la resposta, no d'una quota fixa.
No exposem GraphQL. Ignora qualsevol comprovació d'introspecció GraphQL: la superfície pública és REST + MCP.
Capçaleres REST
Les rutes limitades envien X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset de SlowAPI a les respostes correctes.
En 429:
| Capçalera | Significat |
|---|---|
Retry-After | Segons d'espera abans de reintentar |
RateLimit | Esborrany IETF: "default";r=<remaining>;t=<reset> |
RateLimit-Policy | Esborrany IETF: "default";q=<limit> |
X-RateLimit-* | Les mateixes dades amb els noms antics |
Exemple:
HTTP/1.1 429 Too Many Requests
Retry-After: 42
RateLimit: "default";r=0;t=42
RateLimit-Policy: "default";q=60Espera els segons de Retry-After i reintenta. No facis un bucle ocupat.
MCP
El servidor MCP usa un topall a part per principal (ara 600 peticions / minut per client OAuth o clau API). No és el limitador SlowAPI de REST.
En 429 MCP també envia Retry-After i RateLimit. L'error JSON-RPC inclou error.data.retry_after_seconds.
Què fer
- Llegeix
Retry-After(oretry_after_secondsa MCP). - Espera almenys aquest temps.
- Si continues rebent 429, redueix el paral·lelisme: els llistats estan paginats a propòsit.
Autenticació de l'API
Autentica l'API de Feedjolt amb claus API enviades com a token Bearer a la capçalera Authorization. Crea, limita i revoca claus, només servidor a servidor.
Errors de l'API
Com informa d'errors l'API de Feedjolt: codis HTTP, que reintentar amb backoff, la capcalera X-Request-ID per a informes, limits de tasa i errors de validacio.