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

StatoCodiceQuando
400INVALID_INPUTIl corpo o un argomento non corrisponde all'operazione: details elenca i campi sbagliati.
401MISSING_API_KEY, INVALID_API_KEY, EXPIRED_API_KEY, WORKSPACE_DELETEDNessuna chiave, una chiave sconosciuta o revocata, una chiave scaduta, oppure il suo spazio di lavoro è stato eliminato.
402INSUFFICIENT_TOKENSUn'operazione a pagamento che i crediti dello spazio di lavoro non riescono a coprire.
403FORBIDDENChi ha creato la chiave non può farlo in questo spazio di lavoro: la stessa regola dell'app.
403PLAN_LIMIT_EXCEEDEDIl 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.
404NOT_FOUNDIl sito, la conversazione, l'attività… non esiste in questo spazio di lavoro.
409CONFLICTGià in corso, oppure in uno stato che non lo permette.
429RATE_LIMITEDTroppe richieste per lo spazio di lavoro: Retry-After dice quando riprovare.
503SERVICE_UNAVAILABLEUn servizio che serve all'operazione è momentaneamente non disponibile: riprova più tardi.
500INTERNAL_ERRORUn 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
API120 richieste al minuto
MCP30 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.

Pronto a far decollare il tuo sito?

Fai la tua prima domanda - semchat ti risponde con un piano d'azione chiaro in pochi secondi.

Gratis · senza registrazione · in 5 secondi