☰ Μενού · Εκδόσεις
Εκδόσεις
Η έκδοση είναι μέρος της διαδρομής: /v1. Μέσα στην v1 μόνο προσθέτουμε.
Αλλαγές που κάνουμε στην v1 χωρίς ειδοποίηση: νέα endpoints, νέα προαιρετικά πεδία αιτήματος, νέα πεδία στις απαντήσεις, νέοι τύποι συμβάντων, νέες τιμές σε πεδία που τεκμηριώνονται ως ανοιχτές λίστες (όπως mechanic ή history_entry.type), νέοι κωδικοί σφάλματος. Γράψτε τον κώδικά σας ώστε να αγνοεί, και όχι να απορρίπτει, άγνωστα πεδία και τιμές.
Ό,τι θα μπορούσε να χαλάσει μια σύνδεση που λειτουργεί (αφαίρεση ή μετονομασία πεδίου, αλλαγή τύπου, μετατροπή προαιρετικού πεδίου σε υποχρεωτικό) πηγαίνει σε νέα έκδοση. Το ανακοινώνουμε τουλάχιστον έξι μήνες νωρίτερα, και η v1 συνεχίζει να λειτουργεί σε αυτό το διάστημα.
Κάθε αλλαγή καταγράφεται στις Αλλαγές.
Το προηγούμενο POS API
Οι συνδέσεις που βασίζονται στο https://loyaltyfy.io/api/pos/v1 συνεχίζουν να λειτουργούν. Οι νέες συνδέσεις πρέπει να χρησιμοποιούν το /api/v1: δέχεται τα ίδια πεδία card_number και gross_amount, λειτουργεί για κάθε τύπο προγράμματος, όχι μόνο για cashback, και προσθέτει webhooks, idempotency keys και δικαιώματα.