Kody błędów
Kody błędów
PgArachne zwraca standardowe obiekty błędów JSON-RPC 2.0. Poniżej znajdują się konkretne kody, które możesz napotkać:
| Kod | Komunikat | Znaczenie |
|---|---|---|
-32700 | Parse error | Serwer otrzymał nieprawidłowy JSON. |
-32601 | Method not found | Funkcja nie istnieje w schemacie. |
-32602 | Invalid params | Argumenty nie odpowiadają sygnaturze funkcji. |
-32001 | Permission denied | Aktualna rola użytkownika nie ma uprawnień do wykonania funkcji (na poziomie bazy danych). |
-32000 | Internal Error | Ogólny błąd serwera (sprawdź logi). |
Aktualne zachowanie: odpowiedzi w czasie działania są mapowane głównie na kody statusu HTTP wraz z polem
message błędu JSON-RPC. Niestandardowy kod JSON-RPC -32001 jest używany przy odmowie roli/uprawnień.Mapowanie statusów HTTP
| HTTP | Typowy komunikat | Kiedy się zdarza |
|---|---|---|
400 | Invalid JSON request/Invalid function name | Nieprawidłowy payload żądania lub format metody. |
401 | Authorization header is missing/Invalid or expired token | Brak lub nieprawidłowa autoryzacja. |
403 | Permission denied for the specified role | SET LOCAL ROLE nie powiodło się (-32001). |
404 | Function does not exist/JWT is disabled/get_jwt was removed | Docelowa metoda nie istnieje (-32601), wywołano /token, gdy JWT_SECRET nie jest skonfigurowany, lub wywołano usuniętą metodę JSON-RPC get_jwt (użyj POST /{prefix}/{database}/token). |
429 | Too many login attempts/Too many failed authentication attempts | Przekroczony limit prób logowania lub uwierzytelnienia (LOGIN_RATE_LIMIT, LOGIN_RATE_LIMIT_PER_IP). |
413 | Request body too large/Response too large/Too many files in response | Żądanie przekracza MAX_REQUEST_BYTES lub odpowiedź /file przekracza FILE_MAX_BYTES / FILE_MAX_ENTRIES. |
500 | Function call failed/Transaction commit failed | Wykonanie lub commit nie powiodły się. |
503 | Database connection failed/Database unavailable | Baza danych lub listener tymczasowo niedostępne. |