La nostra API è stata progettata per avere URL prevedibili, orientati alle risorse e per usare i codici di risposta HTTP per indicare gli errori dell'API. Utilizziamo funzioni HTTP integrate, come i verbi HTTP, che possono essere compresi dai client HTTP off-the-shelf. Attualmente solo il formato JSON verrà restituito in tutte le risposte dell'API, inclusi errori e dati.
1. API Workflow
2. Configura il tuo ambiente di prova
Per l'autenticazione utilizzeremo semplici principi basati sull'HMAC.
Per query di prova, utilizza la tua chiave PUBBLICA.
Puoi trovare la tua chiave nella Dashboard:
Connectivity > API configuration > Generate keys
Per query di prova, utilizza la tua chiave PUBBLICA.
Puoi trovare la tua chiave nella Dashboard:
Connectivity > API configuration > Generate keys
Sandbox vs. Live
Le offerte che potresti aver pubblicato sul tuo ticketshop non appariranno sul tuo ambiente sandbox e non potranno essere recuperate attraverso la chiave Pubblica, quindi non dimenticare di pubblicare le tue offerte su regiondo-dev-de.de per poter testare l'implementazione della tua API
Importante
Ricorda: non inviare mai la chiave PRIVATA con le chiamate all'API. Devi inviarci in formato aperto solo la chiave PUBBLICA e usare la chiave PRIVATA per crittografare e "firmare" le richieste dell'API.
3. Documentazione
La nostra documentazione o il nostro PDF scaricabile dovrebbe essere autoesplicativo per qualsiasi sviluppatore, ma accertati di non dimenticare di cliccare su Response Sample e Response Schema per poter capire la struttura dei nostri dati
Note
- Puoi trovare alcuni esempi di codici su GitHub: https://github.com/regiondo-dev/api
- Quando si utilizza la Request URL di una Call API, non dimenticare di rimuovere la parte "sandbox-", proprio all'inizio, e di assicurarsi che non ci siano spazi vuoti alla fine.