Différences
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
|
tecdoc:api [2023/07/14 16:45] mactar.ba |
tecdoc:api [2023/07/26 08:39] (Version actuelle) mactar.ba |
||
|---|---|---|---|
| Ligne 4: | Ligne 4: | ||
| ===== Vue d'ensemble ===== | ===== Vue d'ensemble ===== | ||
| - | <color #ff7f27><schéma de présentation des différents composantes et de leurs interactions via API></color> **todo** | + | |
| + | {{ :tecdoc:cynodthirdpartypaymentgateway-overview-wiki-version.jpg?nolink |}} | ||
| ===== Sécurité ===== | ===== Sécurité ===== | ||
| Ligne 73: | Ligne 74: | ||
| ===== 3rd Party API ===== | ===== 3rd Party API ===== | ||
| Cette section référence les API CYNOD qui sont mises à la disposition des partenaires pour construire des services digitaux au service de tous. | Cette section référence les API CYNOD qui sont mises à la disposition des partenaires pour construire des services digitaux au service de tous. | ||
| - | === API de consultation de solde carte === | + | ==== API de consultation de solde carte ==== |
| ^ Type | <color #22b14c>**GET**</color> | | ^ Type | <color #22b14c>**GET**</color> | | ||
| ^ URI | /get-solde-carte | | ^ URI | /get-solde-carte | | ||
| Ligne 124: | Ligne 125: | ||
| </code> | </code> | ||
| - | === API de vérification de validité d’une carte === | + | ==== API de vérification de validité d’une carte ==== |
| - | === API de vérification de validité d’une carte en fonction d’un membre === | + | ^ Type | <color #22b14c>**GET**</color> | |
| - | === API de récupération de la liste de carte d’un membre ou client === | + | ^ URI | /check-card-validity | |
| - | === API crédit carte === | + | ^ Description | envoi d’une requête pour la validité d’une carte | |
| - | === API access token === | + | |
| + | __**Paramètres :**__ | ||
| + | ^ Nom ^ Description ^ | ||
| + | | numeroCarte | Numéro de la carte du client | | ||
| + | | walletId | Numéro de téléphone du client | | ||
| + | | clientId | Identifiant du client | | ||
| + | |||
| + | __**Header :**__ | ||
| + | ^ Content-type | application/json | | ||
| + | ^ Authorization |Bearer %%{{ACCESS_TOKEN}}%% | | ||
| + | |||
| + | __**Request body :**__ | ||
| + | |||
| + | <wrap hi>Aucun</wrap> | ||
| + | |||
| + | __**Réponses :**__ | ||
| + | ^ Code http | 200 | | ||
| + | ^ Description | Success | | ||
| + | __//Exemple modèle payload json//__ | ||
| + | <code> | ||
| + | { | ||
| + | "success": true, | ||
| + | "code": 200, | ||
| + | "message": "Votre carte est valide et valable jusqu'au 18/07/2029", | ||
| + | "data": [ | ||
| + | { | ||
| + | "numeroCarte": "7019800100009569", | ||
| + | "finValidite": "18/07/2029", | ||
| + | "nom": "xxx", | ||
| + | "prenom": "xxx", | ||
| + | "email": "", | ||
| + | "telephone": "", | ||
| + | "numeroPiece": "", | ||
| + | "dateNaissance": "" | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | ^ Code http | 400 | | ||
| + | ^ Description | Bad request | | ||
| + | __//Exemple modèle payload json//__ | ||
| + | <code> | ||
| + | { | ||
| + | "success": false, | ||
| + | "code": "405", | ||
| + | "message": "Paramètere numeroCarte manquant ou invalide", | ||
| + | "debugMessage": null, | ||
| + | "moreInfo": null | ||
| + | } | ||
| + | </code> | ||
| + | ==== API de vérification de validité d’une carte en fonction d’un membre ==== | ||
| + | ==== API de récupération de la liste de carte d’un membre ou client ==== | ||
| + | ==== API crédit carte (recharge) ==== | ||
| + | ==== API dédit carte (paiement) ==== | ||
| + | ==== API access token ==== | ||