Unsere API ist so konzipiert, dass sie vorhersehbare, ressourcenorientierte URLs enthält und HTTP-Antwortcodes verwendet, um API-Fehler anzuzeigen. Wir verwenden integrierte HTTP-Funktionen, wie z.B. HTTP-Verben, die von handelsüblichen HTTP-Clients erkannt werden können. Derzeit wird in allen Antworten der API, einschließlich Fehler und Daten, nur das JSON-Format zurückgegeben.
1. API Workflow
2. Stellen Sie Ihre Testumgebung auf
Für die Authentifizierung verwenden wir einfache HMAC basierende Prinzipien.
Bei Testauswertungen verwenden Sie bitte Ihren PUBLIC-Schlüssel.
Sie finden Ihren Schlüssel in Ihrem Dashboard:
Connectivity > API configuration > Generate keys
Bei Testauswertungen verwenden Sie bitte Ihren PUBLIC-Schlüssel.
Sie finden Ihren Schlüssel in Ihrem Dashboard:
Connectivity > API configuration > Generate keys
Sandbox vs. Live
Angebote, die Sie möglicherweise in Ihrem Ticketshop veröffentlicht haben, erscheinen nicht in Ihrer Sandbox-Umgebung und sind nicht über den öffentlichen Schlüssel abrufbar, also vergessen Sie bitte nicht, Ihre Angebote auf regiondo-dev-de.de zu veröffentlichen, um Ihre API-Implementierung zu testen.
Wichtig
Denken Sie daran, dass Sie niemals einen PRIVATE-Schlüssel mit API-Aufrufen senden dürfen. Sie müssen uns nur den öffentlichen Schlüssel im offenen Format zusenden und den PRIVATE-Schlüssel auf Ihrer Seite verwenden, um API-Anfragen zu verschlüsseln und zu "signieren".
3. Dokumentation
Unsere Dokumentation oder unser herunterladbares PDF sollte für jeden Entwickler selbsterklärend sein, aber bitte stellen Sie sicher, dass Sie nicht vergessen, auf Response Sample und Response Schema zu klicken, um unsere Datenstrukturen zu verstehen.
Bemerkungen
- Einige Codebeispiele finden Sie unter GitHub: https://github.com/regiondo-dev/api
- Wenn Sie die Request-URL eines API-Calls verwenden, vergessen Sie bitte nicht, den "sandbox-"-Teil ganz am Anfang zu entfernen und stellen Sie sicher, dass am Ende kein extra Leerzeichen vorhanden ist.