Τρέξτε τη διανομή μέσα από το δικό σας προϊόν

Το 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. 1

    Πάρτε τα κλειδιά σας

    Κάντε αίτηση για λογαριασμό. Μόλις εγκριθεί, δημιουργήστε ένα κλειδί sandbox.

  2. 2

    Αναπτύξτε στο sandbox

    Δημιουργήστε κυκλοφορίες και εκτελέστε δοκιμαστικές παραδόσεις μέχρι η ενσωμάτωσή σας να χειρίζεται κάθε κατάσταση.

  3. 3

    Ζητήστε πρόσβαση παραγωγής

    Πείτε μας τι φτιάχνετε. Το εξετάζουμε και εκδίδουμε κλειδιά παραγωγής.

  4. 4

    Παράδοση

    Αλλάξτε στο κλειδί παραγωγής και οι ίδιες κλήσεις φτάνουν σε πραγματικά καταστήματα.

Ερωτήσεις για το Engine

Όχι. Η αναφορά είναι δημόσια. Χρειάζεστε λογαριασμό, τον οποίο ανοίγουμε κατόπιν αίτησης, μόνο όταν θέλετε κλειδί.

Ναι. Μια κυκλοφορία που δημιουργείται μέσω API εμφανίζεται στον πίνακα ελέγχου και μια που δημιουργείται στον πίνακα ελέγχου μπορεί να διαβαστεί και να παραδοθεί μέσω API.

Η παράδοση περνά από τις ίδιες καταστάσεις με μια πραγματική και στέλνει τα ίδια webhooks, αλλά τίποτα δεν αποστέλλεται σε κατάστημα.

Κάντε το πρώτο σας αίτημα στο sandbox