Λογότυπο Ninjabuy

Χειριστείτε τη σύμβαση αποκρίσεων προβλημάτων και συσχετίστε αιτήματα.

Τα σφάλματα ακολουθούν τη σύμβαση JSON προβλημάτων του RFC 9457, με τύπο μέσου application/problem+json.

{
  "type": "https://www.ninjabuy.com/api/v1/problems/bad-body",
  "title": "Invalid request",
  "status": 400,
  "detail": "The request did not match the expected shape.",
  "request_id": "REQUEST_ID",
  "errors": [{"pointer": "/links", "detail": "Validation detail"}]
}

Το type είναι το σταθερό αναγνωριστικό προβλήματος· τα title και detail το περιγράφουν. Το status αντιστοιχεί στην κατάσταση HTTP. Οι προαιρετικές εγγραφές errors περιέχουν JSON Pointer και λεπτομέρεια επικύρωσης· κενός δείκτης σημαίνει ολόκληρο το σώμα. Αναφέρετε το request_id (επίσης στο X-Request-Id) όταν αναφέρετε πρόβλημα.

Όλοι οι παρακάτω τύποι ξεκινούν με https://www.ninjabuy.com/api/v1/problems/.

Κατάληξη τύπου	HTTP	Σημασία / ενέργεια
`bad-json`	400	Το σώμα δεν είναι έγκυρο JSON. Διορθώστε τη σύνταξή του.
`bad-body`	400	Το σώμα, οι παράμετροι ερωτήματος ή ο δρομέας αποτυγχάνουν στην επικύρωση. Διαβάστε το `errors`.
`bad-idempotency-key`	400	Χρησιμοποιήστε 1 έως 255 εκτυπώσιμους χαρακτήρες ASCII για το `Idempotency-Key`.
`unauthorized`	401	Παρέχετε έγκυρο διακριτικό bearer· το `WWW-Authenticate` παρέχει στοιχεία ανακάλυψης.
`not-found`	404	Ο πόρος δεν είναι διαθέσιμος, είναι άγνωστος ή δεν ανήκει σε αυτόν τον λογαριασμό.
`method-not-allowed`	405	Χρησιμοποιήστε τη μέθοδο στο `Allow`.
`idempotency-key-in-progress`	409	Το πρώτο αίτημα με αυτό το κλειδί εκτελείται. Περιμένετε σύμφωνα με το `Retry-After`.
`upload-too-large`	413	Τα μεταφορτωμένα byte υπερβαίνουν το δηλωμένο μέγεθος ή το όριο 20 MiB.
`unsupported-media-type`	415	Στείλτε `Content-Type: application/json`.
`idempotency-key-reused`	422	Αυτό το κλειδί χρησιμοποιήθηκε με άλλο αίτημα. Χρησιμοποιήστε νέο κλειδί.
`invalid-workbook`	422	Η μεταφόρτωση δεν είναι αναγνώσιμο XLSX/CSV εντός των ορίων. Διαβάστε το `errors`.
`upload-expired`	422	Η δέσμευση μεταφόρτωσης έληξε. Μεταφορτώστε ξανά το αρχείο.
`rate-limited`	429	Περιμένετε τα δευτερόλεπτα του `Retry-After` πριν ξαναπροσπαθήσετε.
`search-rate-limited`	429	Το παράθυρο αναζήτησης λέξεων-κλειδιών είναι πλήρες. Περιμένετε σύμφωνα με το `Retry-After`.
`service-unavailable`	503	Δοκιμάστε ξανά σύντομα· τηρήστε το `Retry-After` εφόσον υπάρχει.
`internal-error`	500	Δοκιμάστε ξανά αργότερα· κρατήστε το αναγνωριστικό αιτήματος αν επιμένει.

Ένα επιτυχές αίτημα μπορεί να περιέχει αποτυχίες για επιμέρους εισόδους. Χειριστείτε τις καταστάσεις συνδέσμων ξεχωριστά από τα σφάλματα HTTP. Χρησιμοποιήστε Idempotency-Key για να επαναλάβετε αίτημα δημιουργίας· χωρίς κλειδί, η επανάληψη υποβολής παρτίδας δημιουργεί άλλη εργασία.

Σφάλματα