Codici di Errore
Codici di Errore
PgArachne restituisce oggetti di errore standard JSON-RPC 2.0. Di seguito sono riportati i codici specifici che potresti incontrare:
| Codice | Messaggio | Significato |
|---|---|---|
-32700 | Parse error | Il server ha ricevuto JSON non valido. |
-32601 | Method not found | La funzione non esiste nello schema. |
-32602 | Invalid params | Gli argomenti non corrispondono alla firma della funzione. |
-32001 | Permission denied | Il ruolo utente corrente non ha i privilegi per eseguire la funzione (livello DB). |
-32000 | Internal Error | Errore generico del server (controlla i log). |
Comportamento attuale: le risposte runtime sono mappate principalmente su status HTTP con campo JSON-RPC
message. Il codice JSON-RPC personalizzato -32001 viene usato per rifiuto di ruolo/permessi.Mappatura degli stati HTTP
| HTTP | Messaggio tipico | Quando accade |
|---|---|---|
400 | Invalid JSON request/Invalid function name | Payload non valido o formato metodo errato. |
401 | Authorization header is missing/Invalid or expired token | Autenticazione mancante o non valida. |
403 | Permission denied for the specified role | SET LOCAL ROLE fallito (-32001). |
404 | Function does not exist/JWT is disabled/get_jwt was removed | Il metodo richiesto non esiste (-32601), è stato chiamato /token senza che JWT_SECRET sia configurato, oppure è stato chiamato il metodo JSON-RPC rimosso get_jwt (usa POST /{prefix}/{database}/token). |
429 | Too many login attempts/Too many failed authentication attempts | Rate limit di login o di autenticazione superato (LOGIN_RATE_LIMIT, LOGIN_RATE_LIMIT_PER_IP). |
413 | Request body too large/Response too large/Too many files in response | La richiesta supera MAX_REQUEST_BYTES, oppure una risposta /file supera FILE_MAX_BYTES / FILE_MAX_ENTRIES. |
500 | Function call failed/Transaction commit failed | Esecuzione o commit falliti. |
503 | Database connection failed/Database unavailable | Database o listener temporaneamente non disponibili. |