Ξεκινήστε
Ανάγνωση
Διαβάζετε τον πόρο πριν τον επεξεργαστείτε και παρέχετε expected_version όπως τεκμηριώνεται.
Εγγραφή
Χρησιμοποιείτε POST για τη δημιουργία υποστηριζόμενων πόρων, PATCH για μερικές ενημερώσεις και DELETE για υποστηριζόμενες διαγραφές.
Απόκριση
Η επανάληψη επιτυχούς λειτουργίας επιστρέφει το αποθηκευμένο αποτέλεσμά της χωρίς να εφαρμόσει ξανά την αλλαγή.
Κεφαλίδες
- Idempotency-Key
- Κάθε εγγραφή πόρου απαιτεί Idempotency-Key. Δημιουργείτε ένα κλειδί ανά λογική λειτουργία. Επαναλαμβάνετε το ίδιο κλειδί, μέθοδο, στόχο και περιεχόμενο όταν επαναλαμβάνετε τη λειτουργία.
- expected_version
- Οι αλλαγές τιμών μπορεί επίσης να απαιτούν εκδόσεις προϊόντος, τιμής, τιμής παραλλαγής ή τιμοκαταλόγου. Αν αλλάξει μια έκδοση, διαβάστε ξανά και προσαρμόστε την ενημέρωση αντί να επιβάλετε παλιά δεδομένα.
Πολιτική επανάληψης
- Η επαναχρησιμοποίηση κλειδιού για διαφορετικό αίτημα παράγει idempotency.key_reused.
- Κάθε παράδειγμα είναι συνθετικό.
- Αντικαταστήστε τα αναγνωριστικά με τιμές από το δικό σας κατάστημα πριν το εκτελέσετε.