Όριο προγράμματος
HTTP 422 Unprocessable Entity
Το τρέχον πρόγραμμά σας δεν επιτρέπει αυτή την ενέργεια. Το ίδιο το αίτημα είναι έγκυρο, αλλά η εκτέλεσή του θα υπερέβαινε ένα όριο του προγράμματός σας. Το API πραγματοποιεί έλεγχο πριν γράψει οτιδήποτε, επομένως δεν έχει δημιουργηθεί τίποτα. Αναβαθμίστε το πρόγραμμά σας ή ελευθερώστε χωρητικότητα, για παράδειγμα διαγράφοντας DPP ή δυναμικούς κώδικες που δεν χρειάζεστε πλέον.
Τυπικές αιτίες
- Ποσόστωση DPP: Το
POST /v1/dpp, τοPOST /v1/dpp/batchή τοPOST /v1/dpp/importθα δημιουργούσε περισσότερα DPP από όσα περιλαμβάνει το πρόγραμμά σας. Μια εισαγωγή προσμετρά μόνο τις έγκυρες σειρές της. Οι μεγάλες εισαγωγές εκτελούνται στο παρασκήνιο και ελέγχουν ξανά την ποσόστωση κατά την έναρξή τους. Αν αυτή έχει συμπληρωθεί στο μεταξύ, η εργασία τερματίζεται με κατάστασηfailed. - Δυναμικοί κώδικες: Το
POST /v1/codesή τοPOST /v1/codes/batchθα υπερέβαινε την ποσόστωση δυναμικών QR κωδίκων του οργανισμού σας. - Μέγεθος παρτίδας (batch): Το
POST /v1/codes/batchπεριέχει περισσότερα στοιχεία από όσα επιτρέπει το πρόγραμμά σας ανά αίτημα. - Σειρές εισαγωγής: Το αρχείο για το
POST /v1/dpp/importέχει περισσότερες σειρές δεδομένων από όσες επιτρέπει το πρόγραμμά σας ανά αίτημα. ΤοPOST /v1/codes/importδέχεται το πολύ 1.000 σειρές σε κάθε πρόγραμμα. - Workspaces και μέλη ομάδας: Το
POST /v1/workspacesή τοPOST /v1/membersθα υπερέβαινε τον αριθμό των Workspaces ή των μελών ομάδας που περιλαμβάνει το πρόγραμμά σας. - Έγγραφα DPP: Το πρόγραμμα Free δεν περιλαμβάνει αποθηκευτικό χώρο εγγράφων για DPP, επομένως τα
POST /v1/dpp/:id/documentsκαιPOST /v1/dpp/:id/imagesαπορρίπτονται εκεί. Στα υπόλοιπα προγράμματα, το όριο είναι ο μέγιστος αριθμός εγγράφων ανά DPP. - Αρχεία: Το
POST /v1/files/uploadθα υπερέβαινε τον μέγιστο αριθμό αρχείων ανά QR κώδικα. - Μητρώο ΕΕ: Το
POST /v1/dpp/:id/registerαπαιτεί πρόγραμμα Business, Agency ή Enterprise.
Απάντηση
Όπου εφαρμόζεται, η απάντηση περιλαμβάνει τα πεδία επέκτασης resource και limit: το resource ονομάζει το όριο (dynamic_codes, batch_size, workspaces ή team_members), το limit είναι η τιμή του στο πρόγραμμά σας. Για τους δυναμικούς κώδικες, το used δείχνει επιπλέον πόσοι κώδικες προσμετρώνται ήδη στην ποσόστωση.
{ "type": "https://docs.qr3.app/errors/plan-limit", "title": "Plan Limit Reached", "status": 422, "detail": "Your plan allows a maximum of 25 dynamic QR code(s). Upgrade to create more.", "resource": "dynamic_codes", "limit": 25, "used": 25}Δεν πρόκειται για όριο ρυθμού
Η δοκιμή αργότερα δεν βοηθά σε αυτό το σφάλμα: το όριο παραμένει μέχρι να αναβαθμίσετε ή να ελευθερώσετε χωρητικότητα. Τα προσωρινά όρια απαντούν αντίθετα με HTTP 429: rate-limited για τα 60 αιτήματα ανά λεπτό ανά API key, rate-limit για όρια σε επίπεδο πόρων, όπως η καθημερινή δημιουργία κωδικών.