Τρέξτε τη διανομή μέσα από το δικό σας προϊόν
Το Engine είναι το API του Aevora. Δημιουργήστε κυκλοφορίες, παραδώστε τες στα καταστήματα, διαβάστε αναλυτικά στοιχεία και διαχειριστείτε royalties μέσω REST, μέσα από το προϊόν που χρησιμοποιούν ήδη οι πελάτες σας. Η τεκμηρίωση είναι δημόσια και υπάρχει sandbox για την ανάπτυξή σας.
- Διεπαφή
- REST και JSON
- Ταυτοποίηση
- Κλειδιά API, ένα σετ ανά περιβάλλον
- Sandbox
- Δοκιμαστικές παραδόσεις, χωρίς καταστήματα
Τέσσερις κλήσεις οδηγούν μια κυκλοφορία από το προσχέδιο στην κατάσταση
Το API ακολουθεί τη διαδρομή που διανύει μια κυκλοφορία στον πίνακα ελέγχου: τη δημιουργείτε, την παραδίδετε, διαβάζετε τους αριθμούς όπως φτάνουν και μετά διαβάζετε την κατάσταση. Επιλέξτε μια κλήση για να δείτε τι στέλνετε και τι επιστρέφει.
- Τα αιτήματα και οι απαντήσεις είναι JSON
- Ένα σφάλμα αναφέρει το πεδίο που απέτυχε και γιατί
- Οι ίδιες κλήσεις λειτουργούν στο sandbox και στην παραγωγή
API Engine
Παραδείγματα αιτημάτωνPOST/v1/releases
Σώμα αιτήματος
{ "title": "Night Drive", "artist": "Mira Kaya", "label": "Northfield Audio", "release_date": "2027-03-12"}Απόκριση
{ "id": "rel_8f2k1", "status": "draft", "upc": null}Τι υπάρχει γύρω από τα endpoints
Οι κλήσεις είναι το σύντομο μέρος μιας ενσωμάτωσης. Αυτά είναι τα στοιχεία που τη διατηρούν σε λειτουργία όταν δεν την παρακολουθεί κανείς.
- Webhooks
- Λάβετε ένα συμβάν όταν αλλάζει η κατάσταση μιας παράδοσης, μια κυκλοφορία γίνεται ενεργή ή μια κατάσταση είναι έτοιμη, ώστε να μην χρειάζεται polling.
- Idempotency keys
- Στείλτε ένα κλειδί με ένα αίτημα εγγραφής και μια επανάληψη επιστρέφει το πρώτο αποτέλεσμα αντί να δημιουργήσει δεύτερη κυκλοφορία.
- Σελιδοποίηση
- Οι λίστες επιστρέφουν έναν δρομέα (cursor). Στείλτε τον πίσω για να πάρετε την επόμενη σελίδα, με την ίδια σειρά κάθε φορά.
- Sandbox
- Ξεχωριστό περιβάλλον με δικά του κλειδιά. Οι παραδόσεις εκτελούνται από την αρχή ως το τέλος και σταματούν πριν από οποιοδήποτε κατάστημα.
- Εκδόσεις
- Η έκδοση είναι μέρος της διαδρομής. Μια αλλαγή που σπάει τη συμβατότητα κυκλοφορεί με νέα έκδοση, ώστε εκείνη με την οποία αναπτύξατε να μένει ως έχει.
- Όρια ρυθμού
- Κάθε απάντηση σάς λέει πόσο από το όριό σας απομένει και ένα αίτημα που περιορίστηκε σάς λέει πότε να ξαναδοκιμάσετε.
Από το πρώτο κλειδί στην ενεργή παράδοση
- 1
Πάρτε τα κλειδιά σας
Κάντε αίτηση για λογαριασμό. Μόλις εγκριθεί, δημιουργήστε ένα κλειδί sandbox.
- 2
Αναπτύξτε στο sandbox
Δημιουργήστε κυκλοφορίες και εκτελέστε δοκιμαστικές παραδόσεις μέχρι η ενσωμάτωσή σας να χειρίζεται κάθε κατάσταση.
- 3
Ζητήστε πρόσβαση παραγωγής
Πείτε μας τι φτιάχνετε. Το εξετάζουμε και εκδίδουμε κλειδιά παραγωγής.
- 4
Παράδοση
Αλλάξτε στο κλειδί παραγωγής και οι ίδιες κλήσεις φτάνουν σε πραγματικά καταστήματα.