DocumentazioneAPI e MCP
Errori e limiti
I codici di errore, cosa significano e quante chiamate al minuto.
Un errore risponde { "error": { "code": "…", "message": "…" } } con il suo stato HTTP. Via MCP, il messaggio dell'errore dello strumento è CODE: message. Basati sul codice, non sul messaggio.
Codici di errore
| Stato | Codice | Quando |
|---|---|---|
400 | INVALID_INPUT | Il corpo o un argomento non corrisponde all'operazione: details elenca i campi sbagliati. |
401 | MISSING_API_KEY, INVALID_API_KEY, EXPIRED_API_KEY, WORKSPACE_DELETED | Nessuna chiave, una chiave sconosciuta o revocata, una chiave scaduta, oppure il suo spazio di lavoro è stato eliminato. |
402 | INSUFFICIENT_TOKENS | Un'operazione a pagamento che i crediti dello spazio di lavoro non riescono a coprire. |
403 | FORBIDDEN | Chi ha creato la chiave non può farlo in questo spazio di lavoro: la stessa regola dell'app. |
403 | PLAN_LIMIT_EXCEEDED | Il piano dello spazio di lavoro non lo include: su un account che non ha mai pagato, i backlink di un concorrente o l'analisi di un concorrente nascosto. |
404 | NOT_FOUND | Il sito, la conversazione, l'attività… non esiste in questo spazio di lavoro. |
409 | CONFLICT | Già in corso, oppure in uno stato che non lo permette. |
429 | RATE_LIMITED | Troppe richieste per lo spazio di lavoro: Retry-After dice quando riprovare. |
503 | SERVICE_UNAVAILABLE | Un servizio che serve all'operazione è momentaneamente non disponibile: riprova più tardi. |
500 | INTERNAL_ERROR | Un errore nostro: riprova più tardi. |
402
{
"error": {
"code": "INSUFFICIENT_TOKENS",
"message": "Workspace is out of tokens for this period."
}
}Limiti di frequenza
| Per spazio di lavoro | |
|---|---|
| API | 120 richieste al minuto |
| MCP | 30 chiamate di strumenti al minuto |
Oltre il limite, la risposta è 429 RATE_LIMITED, con un header Retry-After che dice quando riprovare.
Hai una domanda a cui qui non trovi risposta? Scrivici.

