Bienvenue
Explorez nos guides et examples pour démarrer votre intégration avec Xplor Resamania V2
WARNING
À partir de décembre 2025, tous les appels directs à l'API Resamania ne seront plus supportés. Pour continuer à utiliser nos services, vous devez migrer vers l'API Gateway.
Vous êtes déjà intégré avec nous et vous ne passez pas par la Gateway ? Contactez-nous à api@resamania.fr en précisant :
- Le nom de votre société
- Les coordonnées de votre contact technique
- Les premiers caractères de votre clé OAuth (exemple : 123_abc)
Notre équipe vous créera un compte Gravitee et vous fournira les accès nécessaires. Attention : cette adresse e-mail est exclusivement réservée aux partenaires déjà intégrés.
Vous souhaitez en savoir plus ? Consultez la documentation API Gateway pour plus d'informations.
Devenir partenaire
Je ne suis pas encore partenaire
Vous avez un projet d'intégration avec nos APIs/webhooks, voici les différentes étapes pour bien démarrer :
Si nous avons déjà un client en commun, invitez votre client à joindre son service commercial afin d'expliquer son besoin.
Une fois le projet cadré commercialement, l'équipe API programmera un "kick-off" avec le client et le partenaire. Lors de cette réunion, nous échangerons autour de votre besoin, nous vous expliquerons nos process d'intégration, et vous aiguillerons sur la bonne mise en place de votre projet.
Vous obtiendrez ensuite vos accès à notre environnement de "sandbox", sur lequel vous pourrez faire vos tests. C'est ici que vous obtiendrez l'accès à notre API Gateway et à son developer portal.
NOTE
L'environnement de sandbox contient des données de test, et non les données finales de l'environnement de production.
Nous ne fournirons pas de données de production sur les environnements de test.
Une fois que vous avez terminé les développements et que vous êtes prêt à passer en production, vous devrez effectuer une phase de tests exhaustive.
Vous choisissez une date et une heure auxquelles vous souhaitez mener les tests et vous effectuez tous les appels nécessaires au fonctionnement de votre application.
Vous informez l'équipe API Resamania de la date, de l'heure et du scénario de cette phase de test. Par exemple : "rechercher un contact", "récupérer le catalogue en filtrant sur le canal web", etc.
N'oubliez pas de tester les cas négatifs et la gestion des erreurs. Par exemple l'ajout au panier d'une offre dont la durée de validité est dépassée, ou l'inscription à un cours collectif déjà complet.
Notre équipe passe ensuite en revue les appels sur la gateway et ouvre en production les endpoints et verbes que vous testés.
Je veux devenir partenaire marché, je n'ai pas encore de client en commun
Vous pouvez nous contacter directement sur la page de contact dédiée ici
Je suis déjà partenaire, je veux ouvrir de nouveaux endpoints
Vous devez alors re-passer par une phase de test sur l'environnement de sandbox afin que notre équipe passe en revue votre usage de ces nouveaux endpoints et ne les ouvre sur les environnements de production.
Je suis déjà partenaire, je veux m'ouvrir à d'autres clients Resamania
Notre client commun peut envoyer un e-mail à notre support (supportv2@resamania.fr) afin de demander l'ouverture. Il devra fournir une décharge vous autorisant à accéder à ses données.
Bien démarrer mon intégration
Commencez par vous familiariser avec cette documentation et tous ses pré-requis. Les étapes que vous allez avoir envie de suivre :
- Découvrez les ressources que nous mettons à votre disposition
- Assurez vous de connaitre nos principes en termine de sécurité et de limitation des appels
- Récupérez vos accès à la sandbox auprès de notre équipe API
- Assurez-vous d'être à l'aise avec les composantes de vos requêtes pour ne rien oubliez
- Réalisez vos premières requêtes via Bruno ou Postman.
- Utilisez la rubrique questions fréquentes si vous avez un doute.