Notre API est conçue pour avoir des URL prévisibles, orientées ressources, et pour utiliser des codes de réponse HTTP indiquant les erreurs de l'API. Nous utilisons des fonctionnalités HTTP intégrées, telles que les verbes HTTP, qui peuvent être comprises par les versions HTTP disponibles dans le commerce. Actuellement, seul le format JSON sera renvoyé dans toutes les réponses de l'API, y compris les erreurs et les données.
1. Flux de travail de l'API
2. Configurez votre environnement de test
Pour l'authentification, nous utilisons des principes simples basés sur HMAC.
Pour les requêtes de test, veuillez utiliser votre clé PUBLIQUE.
Pour les requêtes de test, veuillez utiliser votre clé PUBLIQUE.
Vous trouverez votre clé dans votre tableau de bord:
Connectivity > API configuration > Generate keys
Sandbox vs. Live
Les offres que vous avez éventuellement publiées sur votre billetterie n'apparaîtront pas dans votre environnement sandbox et ne seront pas récupérables à l'aide de la clé publique. N'oubliez donc pas de publier vos offres sur regiondo-dev-de.de afin de tester votre implémentation d'API.
Important
Rappelez-vous - n'envoyez jamais de clé PRIVÉE avec des appels d'API. Vous devez nous envoyer uniquement la clé PUBLIQUE au format ouvert et utiliser la clé PRIVÉE de votre côté pour chiffrer et "signer" les demandes d'API.
3. Documentation
Notre documentation ou notre PDF téléchargeable devrait être explicite pour tout développeur, mais assurez-vous de ne pas oublier de cliquer sur Response Sample et sur Response Schema afin de comprendre notre structure de données.
Remarques
- Vous trouverez quelques exemples de code sur GitHub: https://github.com/regiondo-dev/api
- Lorsque vous utilisez le Request URL d'un API Call, n'oubliez pas de supprimer la partie "sandbox-", juste au début, et assurez-vous qu'il n'y a pas d'espace vide à la fin.