Κωδικοί Σφαλμάτων
Κωδικοί Σφαλμάτων
Το PgArachne επιστρέφει τυπικά αντικείμενα σφαλμάτων JSON-RPC 2.0. Παρακάτω είναι οι συγκεκριμένοι κωδικοί που μπορεί να συναντήσετε:
| Κωδικός | Μήνυμα | Σημασία |
|---|---|---|
-32700 | Parse error | Ελήφθη μη έγκυρη JSON από τον server. |
-32601 | Method not found | Η function δεν υπάρχει στο σχήμα. |
-32602 | Invalid params | Τα arguments δεν ταιριάζουν με το signature της function. |
-32001 | Permission denied | Ο τρέχων ρόλος χρήστη δεν έχει δικαιώματα εκτέλεσης της function (επίπεδο DB). |
-32000 | Internal Error | Γενικό σφάλμα server (ελέγξτε τα logs). |
Τρέχουσα συμπεριφορά: οι απαντήσεις runtime αντιστοιχίζονται κυρίως σε HTTP status codes με ένα JSON-RPC error
message. Ο custom κωδικός JSON-RPC -32001 χρησιμοποιείται για άρνηση ρόλου/δικαιώματος.Αντιστοίχιση HTTP Status
| HTTP | Τυπικό μήνυμα | Πότε συμβαίνει |
|---|---|---|
400 | Invalid JSON request/Invalid function name | Κακοσχηματισμένο payload request ή μορφή method. |
401 | Authorization header is missing/Invalid or expired token | Απούσα ή μη έγκυρη authentication. |
403 | Permission denied for the specified role | Το SET LOCAL ROLE απέτυχε (-32001). |
404 | Function does not exist/JWT is disabled/get_jwt was removed | Η function-στόχος λείπει (-32601), κλήθηκε το /token ενώ το JWT_SECRET δεν έχει ρυθμιστεί, ή κλήθηκε η αφαιρεθείσα μέθοδος JSON-RPC get_jwt (χρησιμοποιήστε POST /{prefix}/{database}/token). |
429 | Too many login attempts/Too many failed authentication attempts | Υπέρβαση του rate limit σύνδεσης ή πιστοποίησης (LOGIN_RATE_LIMIT, LOGIN_RATE_LIMIT_PER_IP). |
413 | Request body too large/Response too large/Too many files in response | Το request υπερβαίνει το MAX_REQUEST_BYTES, ή μια απάντηση /file υπερβαίνει το FILE_MAX_BYTES / FILE_MAX_ENTRIES. |
500 | Function call failed/Transaction commit failed | Αποτυχία εκτέλεσης ή commit. |
503 | Database connection failed/Database unavailable | Προσωρινή μη διαθεσιμότητα βάσης δεδομένων ή listener. |