Spécifications de base
Quelques spécifications pour vous aider à comprendre l’API MeSomb et à l’intégrer à votre produit.
Format pris en charge
- Toutes les réponses de l’API MeSomb sont renvoyées au format JSON
- Les requêtes POST vers le serveur doivent être envoyées en JSON, mais aussi en données de formulaire (si la requête contient un fichier)
Codes de réponse HTTP
Les codes d’état sont renvoyés comme des codes HTTP par défaut.
| Code d’état | Description |
|---|---|
| 200 OK | Réponse standard pour les requêtes réussies. Tout est OK |
| 400 Erreur du client | Erreur du client lors de l’appel à l’API MeSomb – veuillez vérifier le message d’erreur renvoyé par l’API MeSomb afin de corriger la requête incorrecte |
| 500 Erreur du serveur | Le serveur n’a pas pu satisfaire une requête apparemment valide. Cela indique une erreur interne de l’API MeSomb. Si vous rencontrez ce problème, veuillez contacter MeSomb en fournissant les étapes permettant de reproduire l’erreur. |
Internationalisation
L’API prend en charge l’internationalisation et prend actuellement en charge 2 langues : le français (fr) et l’anglais (en). En définissant la langue, tous les messages (principalement les descriptions d’erreur) reçus de MeSomb seront dans la langue choisie.
La langue est définie par le code ajouté au début de l’URL : en pour l’anglais et fr pour le français. Exemple : https://business.mesomb.com/[en|fr]/api/v1.1/payment/collect
Environnements
Cette documentation présente les services web par leur chemin relatif (par exemple GET /ping). Vous devez créer votre service sur MeSomb pour accéder à notre API. Veuillez Open a ticket en cas de problème.
Votre service est matérialisé dans notre système par une application. Lors de sa création, votre application est en mode DEVELOPMENT, ce qui signifie que vous ne pouvez effectuer aucune transaction en production et que vous pouvez uniquement utiliser les informations spécifiques fournies dans ce document pour les tests.
Lorsque vous serez prêt à soumettre votre application, accédez à notre processus de mise en production, et une fois approuvé, vous serez prêt à démarrer.
SSL
Toutes les requêtes sur le système doivent être envoyées via HTTPS uniquement afin de chiffrer tous les messages sur le réseau.
Partage de ressources entre origines croisées
L’API MeSomb prend en charge le partage de ressources entre origines (CORS) conformément à la spécification W3C. Cela permet au navigateur de communiquer entre domaines. Toutes les réponses autorisent les origines avec un caractère générique, ce qui les rend accessibles depuis n’importe quel site.
