Migration de v2 vers v3

Vue d’ensemble

Ce guide vous montre exactement ce qu’il faut modifier lors de la migration de l’API OneClickDz Flexy v2 vers v3. Chaque exemple présente votre code v2 actuel, liste les changements à effectuer et montre le résultat en v3. Disponible en plusieurs langages : exemples JavaScript/Node.js, PHP et Python inclus.

Dépréciation de l’API v2 : L’API v2 sera dépréciée le 30 octobre 2026. Veuillez migrer avant cette date pour éviter toute interruption de service.

Nouveautés de v3

Réponses standardisées

Toutes les réponses encapsulées dans la structure {(success, data, meta, requestId)}

Meilleure gestion des erreurs

Erreurs structurées avec codes, messages et détails pour un débogage plus facile

Débogage amélioré

Chaque réponse inclut des horodatages et des IDs de requête uniques

Endpoints plus clairs

Regroupement logique : /mobile/*, /internet/*, /gift-cards/*, /account/*

Clés API séparées

Générez des clés sandbox dédiées pour les tests tout en conservant votre clé de production

Liste blanche d'IP

Ajoutez des restrictions IP directement depuis la page des paramètres pour une sécurité renforcée

Liste de contrôle de migration rapide

Générer une clé API sandbox (optionnel)

Créez une clé API sandbox depuis la page des paramètres de votre tableau de bord pour tester v3 avant de migrer la production

Configurer la liste blanche d'IP (optionnel)

Ajoutez des restrictions IP pour une sécurité renforcée directement depuis les paramètres

Mettre à jour l'en-tête d'authentification

Passez de authorization à X-Access-Token dans toutes les requêtes API

Mettre à jour la gestion des réponses

Accédez aux données via result.data au lieu d’y accéder directement depuis la réponse

Mettre à jour la gestion des erreurs

Vérifiez le booléen result.success et gérez l’objet structuré result.error

Mettre à jour les chemins des endpoints

Mappez les chemins v2 vers les nouveaux chemins v3 (voir le tableau de référence complet ci-dessous)

Mettre à jour la logique de pagination

Accédez aux informations de pagination depuis result.data.pagination au lieu du niveau racine

Choisissez votre stratégie de migration

Bonne nouvelle : Les APIs v2 et v3 fonctionnent simultanément jusqu’à la dépréciation de v2. Votre clé API de production actuelle fonctionne avec les endpoints v2 et v3, vous offrant une flexibilité dans votre migration.

Changement d’URL de base : v3 utilise une nouvelle URL de base : - v2 : https://flexy-api.oneclickdz.com/v2 - v3 : https://api.oneclickdz.com/v3

Nouvelles fonctionnalités de sécurité : v3 introduit la gestion de clés API sandbox séparées pour les tests, ainsi que la liste blanche d’IP directement depuis la page des paramètres de votre tableau de bord. Votre clé de production continue de fonctionner avec v2 et v3.

Choisissez l’approche qui correspond à vos besoins :

🆕 Nouveau départ

Idéal pour : Refonte complète ou nouveaux projets

Générez une clé sandbox pour les tests depuis les paramètres
Configurez la liste blanche d’IP pour la clé de production
Testez tout en sandbox avec v3
Utilisez la clé de production quand vous êtes prêt

✅ Table rase, pas de code hérité ✅ Sécurité renforcée avec les restrictions IP

🔄 Migration progressive

Idéal pour : Systèmes de production existants

Continuez d’utiliser la clé de production actuelle pour les endpoints v2
Générez une clé sandbox pour tester v3 en toute sécurité
Migrez les endpoints un par un vers v3
Exécutez v2 et v3 en parallèle avec la même clé de production

✅ Zéro temps d’arrêt, moins de risques ✅ Migrez à votre rythme

Recommandé : La plupart des équipes choisissent la migration progressive pour minimiser les risques. Vous pouvez d’abord mettre à jour les endpoints critiques tout en maintenant les autres sur v2.

Migration intelligente : Commencez par les cartes cadeaux

Conseil pro : Si vous êtes intéressé par les cartes cadeaux, intégrez-les d’abord sur v3 ! Vous n’avez pas besoin de migrer vos recharges mobiles et internet existantes pour commencer à utiliser les cartes cadeaux sur v3. C’est une façon peu risquée de tester v3 tout en maintenant vos opérations critiques sur v2. Utilisez votre clé sandbox pour tester, puis passez en production quand vous êtes prêt.

Ordre de migration suggéré :

Phase 1 : Intégrer les cartes cadeaux sur v3 (si applicable)
- Générez une clé sandbox pour les tests
- Utilisez les endpoints /v3/gift-cards/* en sandbox
- Testez soigneusement, puis utilisez la clé de production
- Maintenez mobile/internet sur v2
Phase 2 : Migrer les endpoints de compte et de validation
- /v3/validate
- /v3/account/balance
- /v3/account/transactions
Phase 3 : Migrer les recharges mobiles progressivement
- Testez d’abord avec des opérations à faible volume
- Surveillez les problèmes
- Augmentez progressivement la migration
Phase 4 : Migrer les recharges internet
- Complétez avant la date limite de dépréciation

Cette approche vous permet de migrer à votre rythme jusqu’à la date de dépréciation tout en profitant des nouvelles fonctionnalités v3.

Les 3 changements principaux

1. En-tête d’authentification

Ce qu’il faut modifier : Renommez l’en-tête de authorization à X-Access-Token

Nouvelle gestion des clés : v3 vous permet de générer une clé API sandbox séparée pour les tests depuis les paramètres de votre tableau de bord. Vous pouvez également ajouter des restrictions de liste blanche d’IP pour une sécurité renforcée. Votre clé API de production existante fonctionne avec les endpoints v2 et v3.

JavaScript
PHP
Python

// Votre code v2 actuel :
fetch("https://flexy-api.oneclickdz.com/v2/plans/listAll", {
  headers: {
    authorization: "YOUR_API_KEY",
  },
});

// Votre code v2 actuel :
$ch = curl_init('https://flexy-api.oneclickdz.com/v2/plans/listAll');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'authorization: YOUR_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

# Votre code v2 actuel :
import requests

response = requests.get(
'https://flexy-api.oneclickdz.com/v2/plans/listAll',
headers={'authorization': 'YOUR_API_KEY'}
)

Modifications nécessaires :

❌ Supprimer : authorization: "YOUR_API_KEY"
✅ Ajouter : X-Access-Token: "YOUR_API_KEY"
✅ Mettre à jour : URL de base vers https://api.oneclickdz.com/v3

Le mécanisme d’authentification reste le même - seul le nom de l’en-tête change. Votre clé API existante fonctionne avec v2 et v3.

JavaScript
PHP
Python

// Code v3 mis à jour :
fetch("https://api.oneclickdz.com/v3/mobile/plans", {
  headers: {
    "X-Access-Token": "YOUR_API_KEY",
  },
});

// Code v3 mis à jour :
$ch = curl_init('https://api.oneclickdz.com/v3/mobile/plans');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-Access-Token: YOUR_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

# Code v3 mis à jour :
import requests

response = requests.get(
'https://api.oneclickdz.com/v3/mobile/plans',
headers={'X-Access-Token': 'YOUR_API_KEY'}
)

2. Structure des réponses

Ce qu’il faut modifier : Toutes les réponses sont maintenant encapsulées dans une structure standard

JavaScript
PHP
Python

// Votre code v2 actuel :
const response = await fetch("https://flexy-api.oneclickdz.com/v2/account/balance", {
  headers: { authorization: API_KEY },
});
const data = await response.json();
console.log("Balance:", data.balance); // Accès direct

// Votre code v2 actuel :
$ch = curl_init('https://flexy-api.oneclickdz.com/v2/account/balance');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['authorization: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);
echo "Balance: " . $data['balance']; // Accès direct

# Votre code v2 actuel :
response = requests.get(
    'https://flexy-api.oneclickdz.com/v2/account/balance',
    headers={'authorization': API_KEY}
)
data = response.json()
print(f"Balance: {data['balance']}")  # Accès direct

Modifications nécessaires :

❌ Supprimer : L’accès direct à data.balance
✅ Ajouter : Vérifiez d’abord result.success
✅ Ajouter : Accédez via result.data.balance
✅ Bonus : Utilisez result.requestId pour le débogage
✅ Bonus : Utilisez result.meta.timestamp pour les informations de timing

Changement majeur : En v3, vous devez toujours vérifier le booléen success avant d’accéder aux données. L’accès direct aux champs causera des erreurs si la requête a échoué.

JavaScript
PHP
Python

// Code v3 mis à jour :
const response = await fetch("https://api.oneclickdz.com/v3/account/balance", {
  headers: { "X-Access-Token": API_KEY },
});
const result = await response.json();

if (result.success) {
  console.log("Balance:", result.data.balance);
  console.log("Request ID:", result.requestId); // Pour le débogage
  console.log("Timestamp:", result.meta.timestamp);
} else {
  console.error("Error:", result.error.message);
}

// Code v3 mis à jour :
$ch = curl_init('https://api.oneclickdz.com/v3/account/balance');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Access-Token: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['success']) {
    echo "Balance: " . $result['data']['balance'] . "\n";
    echo "Request ID: " . $result['requestId'] . "\n";
    echo "Timestamp: " . $result['meta']['timestamp'] . "\n";
} else {
    error_log("Error: " . $result['error']['message']);
}

# Code v3 mis à jour :
response = requests.get(
    'https://api.oneclickdz.com/v3/account/balance',
    headers={'X-Access-Token': API_KEY}
)
result = response.json()

if result['success']:
    print(f"Balance: {result['data']['balance']}")
    print(f"Request ID: {result['requestId']}")  # Pour le débogage
    print(f"Timestamp: {result['meta']['timestamp']}")
else:
    print(f"Error: {result['error']['message']}")

3. Gestion des erreurs

Ce qu’il faut modifier : Les erreurs sont maintenant des objets structurés avec des codes

JavaScript
PHP
Python

// Votre code v2 actuel :
const response = await fetch("https://flexy-api.oneclickdz.com/v2/topup/sendTopup", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    authorization: API_KEY,
  },
  body: JSON.stringify(data),
});

const result = await response.json();
if (result.error) {
  console.error("Error:", result.message); // Chaîne simple
}

// Votre code v2 actuel :
$ch = curl_init('https://flexy-api.oneclickdz.com/v2/topup/sendTopup');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'authorization: ' . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if (isset($result['error'])) {
    error_log("Error: " . $result['message']); // Chaîne simple
}

# Votre code v2 actuel :
response = requests.post(
    'https://flexy-api.oneclickdz.com/v2/topup/sendTopup',
    headers={
        'Content-Type': 'application/json',
        'authorization': API_KEY
    },
    json=data
)
result = response.json()

if 'error' in result:
    print(f"Error: {result['message']}")  # Chaîne simple

Modifications nécessaires :

❌ Supprimer : La vérification de la chaîne result.error
✅ Ajouter : Vérifiez result.success === false
✅ Ajouter : Accédez à result.error.code et result.error.message
✅ Ajouter : Gérez les différents codes d’erreur avec des switch/if
✅ Ajouter : Journalisez result.requestId pour les tickets de support

Conseil pro : Sauvegardez toujours le requestId lors de la journalisation des erreurs. Notre équipe de support en a besoin pour tracer les problèmes dans notre système.

JavaScript
PHP
Python

// Code v3 mis à jour :
const response = await fetch("https://api.oneclickdz.com/v3/mobile/send", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Access-Token": API_KEY,
  },
  body: JSON.stringify(data),
});

const result = await response.json();

if (!result.success) {
  console.error(`Error [${result.error.code}]: ${result.error.message}`);
  console.log("Request ID:", result.requestId);

  switch (result.error.code) {
    case "INSUFFICIENT_BALANCE":
      alert("Veuillez recharger votre compte");
      break;
    case "ERR_PHONE":
      alert(`Numéro de téléphone invalide : ${result.error.message}`);
      break;
    case "DUPLICATED_REF":
      alert("Cette référence de commande a déjà été utilisée");
      break;
    default:
      alert("Une erreur s'est produite. Veuillez réessayer.");
  }
}

// Code v3 mis à jour :
$ch = curl_init('https://api.oneclickdz.com/v3/mobile/send');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'X-Access-Token: ' . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if (!$result['success']) {
    $errorCode = $result['error']['code'];
    $errorMessage = $result['error']['message'];
    error_log("Error [{$errorCode}]: {$errorMessage}");
    error_log("Request ID: " . $result['requestId']);

    switch ($errorCode) {
        case 'INSUFFICIENT_BALANCE':
            echo "Veuillez recharger votre compte\n";
            break;
        case 'ERR_PHONE':
            echo "Numéro de téléphone invalide : {$errorMessage}\n";
            break;
        case 'DUPLICATED_REF':
            echo "Cette référence de commande a déjà été utilisée\n";
            break;
        default:
            echo "Une erreur s'est produite. Veuillez réessayer\n";
    }
}

# Code v3 mis à jour :
response = requests.post(
    'https://api.oneclickdz.com/v3/mobile/send',
    headers={
        'Content-Type': 'application/json',
        'X-Access-Token': API_KEY
    },
    json=data
)
result = response.json()

if not result['success']:
    error_code = result['error']['code']
    error_message = result['error']['message']
    print(f"Error [{error_code}]: {error_message}")
    print(f"Request ID: {result['requestId']}")

    if error_code == 'INSUFFICIENT_BALANCE':
        print("Veuillez recharger votre compte")
    elif error_code == 'ERR_PHONE':
        print(f"Numéro de téléphone invalide : {error_message}")
    elif error_code == 'DUPLICATED_REF':
        print("Cette référence de commande a déjà été utilisée")
    else:
        print("Une erreur s'est produite. Veuillez réessayer.")

Exemples de migration étape par étape

Exemple 1 : Récupérer les forfaits mobiles

Étape 1 - Votre code v2 actuel :

JavaScript
PHP
Python

const response = await fetch("https://flexy-api.oneclickdz.com/v2/plans/listAll", {
  headers: {
    authorization: API_KEY,
  },
});

const data = await response.json();
const dynamicPlans = data.dymanicPlans; // Note: typo in v2
const fixedPlans = data.fixedPlans;

$ch = curl_init('https://flexy-api.oneclickdz.com/v2/plans/listAll');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['authorization: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);

$dynamicPlans = $data['dymanicPlans']; // Note: typo in v2
$fixedPlans = $data['fixedPlans'];

response = requests.get(
    'https://flexy-api.oneclickdz.com/v2/plans/listAll',
    headers={'authorization': API_KEY}
)
data = response.json()

dynamic_plans = data['dymanicPlans']  # Note: typo in v2
fixed_plans = data['fixedPlans']

Étape 2 - Ce qu’il faut changer :

Changer l’URL de base : https://flexy-api.oneclickdz.com → https://api.oneclickdz.com
Changer l’endpoint : /v2/plans/listAll → /v3/mobile/plans
Changer l’en-tête : authorization → X-Access-Token
Ajouter la vérification de succès : if (result.success)
Accéder via data : data.dymanicPlans → result.data.dynamicPlans (faute corrigée !)

OBLIGATOIRE : v3 corrige la faute de frappe dans “dymanicPlans” en “dynamicPlans”. Mettez à jour votre code pour utiliser l’orthographe correcte.

Étape 3 - Votre nouveau code v3 :

JavaScript
PHP
Python

const response = await fetch("https://api.oneclickdz.com/v3/mobile/plans", {
  headers: {
    "X-Access-Token": API_KEY,
  },
});

const result = await response.json();
if (result.success) {
  const dynamicPlans = result.data.dynamicPlans; // Faute corrigée !
  const fixedPlans = result.data.fixedPlans;
}

$ch = curl_init('https://api.oneclickdz.com/v3/mobile/plans');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Access-Token: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['success']) {
    $dynamicPlans = $result['data']['dynamicPlans']; // Faute corrigée !
    $fixedPlans = $result['data']['fixedPlans'];
}

response = requests.get(
    'https://api.oneclickdz.com/v3/mobile/plans',
    headers={'X-Access-Token': API_KEY}
)
result = response.json()

if result['success']:
    dynamic_plans = result['data']['dynamicPlans']  # Faute corrigée !
    fixed_plans = result['data']['fixedPlans']

Exemple 2 : Envoyer une recharge mobile

Étape 1 - Votre code v2 actuel :

JavaScript
PHP
Python

const response = await fetch("https://flexy-api.oneclickdz.com/v2/topup/sendTopup", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    authorization: API_KEY,
  },
  body: JSON.stringify({
    plan_code: "PREPAID_DJEZZY",
    MSSIDN: "0778037340",
    amount: 500,
    ref: "order-123",
  }),
});

const data = await response.json();
console.log("Topup ID:", data.topupId);
console.log("New Balance:", data.newBalance);

$data = [
    'plan_code' => 'PREPAID_DJEZZY',
    'MSSIDN' => '0778037340',
    'amount' => 500,
    'ref' => 'order-123'
];

$ch = curl_init('https://flexy-api.oneclickdz.com/v2/topup/sendTopup');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'authorization: ' . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

echo "Topup ID: " . $result['topupId'] . "\n";
echo "New Balance: " . $result['newBalance'] . "\n";

data = {
    'plan_code': 'PREPAID_DJEZZY',
    'MSSIDN': '0778037340',
    'amount': 500,
    'ref': 'order-123'
}

response = requests.post(
    'https://flexy-api.oneclickdz.com/v2/topup/sendTopup',
    headers={
        'Content-Type': 'application/json',
        'authorization': API_KEY
    },
    json=data
)
result = response.json()

print(f"Topup ID: {result['topupId']}")
print(f"New Balance: {result['newBalance']}")

Étape 2 - Ce qu’il faut changer :

Changer l’URL de base : https://flexy-api.oneclickdz.com → https://api.oneclickdz.com
Changer l’endpoint : /v2/topup/sendTopup → /v3/mobile/send
Changer l’en-tête : authorization → X-Access-Token
Ajouter la vérification de succès : if (result.success)
Accéder via data : data.topupId → result.data.topupId
Ajouter une gestion complète des erreurs

Important : Gérez toujours les erreurs lors de l’envoi de recharges. Les problèmes réseau, le solde insuffisant ou des données invalides peuvent causer des échecs. Sauvegardez le requestId pour le suivi.

Étape 3 - Votre nouveau code v3 :

JavaScript
PHP
Python

const response = await fetch("https://api.oneclickdz.com/v3/mobile/send", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Access-Token": API_KEY,
  },
  body: JSON.stringify({
    plan_code: "PREPAID_DJEZZY",
    MSSIDN: "0778037340",
    amount: 500,
    ref: "order-123",
  }),
});

const result = await response.json();
if (result.success) {
  console.log("✅ Recharge envoyée avec succès !");
  console.log("Topup ID:", result.data.topupId);
  console.log("Nouveau solde:", result.data.newBalance);
  console.log("Request ID:", result.requestId);
} else {
  console.error(`❌ Erreur [${result.error.code}]: ${result.error.message}`);
  console.error("Request ID:", result.requestId);
}

$ch = curl_init('https://api.oneclickdz.com/v3/mobile/send');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'X-Access-Token: ' . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['success']) {
    echo "✅ Recharge envoyée avec succès !\n";
    echo "Topup ID: " . $result['data']['topupId'] . "\n";
    echo "Nouveau solde: " . $result['data']['newBalance'] . "\n";
    echo "Request ID: " . $result['requestId'] . "\n";
} else {
    error_log("❌ Erreur [{$result['error']['code']}]: {$result['error']['message']}");
    error_log("Request ID: " . $result['requestId']);
}

response = requests.post(
    'https://api.oneclickdz.com/v3/mobile/send',
    headers={
        'Content-Type': 'application/json',
        'X-Access-Token': API_KEY
    },
    json=data
)
result = response.json()

if result['success']:
    print("✅ Recharge envoyée avec succès !")
    print(f"Topup ID: {result['data']['topupId']}")
    print(f"Nouveau solde: {result['data']['newBalance']}")
    print(f"Request ID: {result['requestId']}")
else:
    print(f"❌ Erreur [{result['error']['code']}]: {result['error']['message']}")
    print(f"Request ID: {result['requestId']}")

Exemple 3 : Vérifier le statut d’une recharge

Étape 1 - Votre code v2 actuel :

JavaScript
PHP
Python

const response = await fetch(
  "https://flexy-api.oneclickdz.com/v2/topup/checkStatus/REF/order-123",
  {
    headers: { authorization: API_KEY },
  }
);

const data = await response.json();
console.log("Statut:", data.topup.status);
console.log("Téléphone:", data.topup.MSSIDN);

$ch = curl_init('https://flexy-api.oneclickdz.com/v2/topup/checkStatus/REF/order-123');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['authorization: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);

echo "Statut: " . $data['topup']['status'] . "\n";
echo "Téléphone: " . $data['topup']['MSSIDN'] . "\n";

response = requests.get(
    'https://flexy-api.oneclickdz.com/v2/topup/checkStatus/REF/order-123',
    headers={'authorization': API_KEY}
)
data = response.json()

print(f"Statut: {data['topup']['status']}")
print(f"Téléphone: {data['topup']['MSSIDN']}")

Étape 2 - Ce qu’il faut changer :

Changer l’URL de base : https://flexy-api.oneclickdz.com → https://api.oneclickdz.com
Changer l’endpoint : /v2/topup/checkStatus/REF/:ref → /v3/mobile/check-ref/:ref
Changer l’en-tête : authorization → X-Access-Token
Ajouter la vérification de succès : if (result.success)
Accéder directement : data.topup.status → result.data.status (plus d’objet topup imbriqué)
Gérer les nouveaux champs d’information sur le remboursement

Nouvelle fonctionnalité : v3 inclut des informations détaillées sur les remboursements avec des offres alternatives suggérées quand une recharge est remboursée.

Étape 3 - Votre nouveau code v3 :

JavaScript
PHP
Python

const response = await fetch(
  "https://api.oneclickdz.com/v3/mobile/check-ref/order-123",
  {
    headers: { "X-Access-Token": API_KEY },
  }
);

const result = await response.json();
if (result.success) {
  console.log("Statut:", result.data.status);
  console.log("Téléphone:", result.data.MSSIDN);

  // Nouveau en v3 : informations de remboursement améliorées
  if (result.data.status === "REFUNDED") {
    console.log("❌ La recharge a été remboursée");
    console.log("Raison:", result.data.refund_message);
    if (result.data.suggested_offers) {
      console.log("💡 Essayez ces offres à la place :");
      console.log(result.data.suggested_offers);
    }
  } else if (result.data.status === "FULFILLED") {
    console.log("✅ Recharge complétée avec succès");
  }
}

$ch = curl_init('https://api.oneclickdz.com/v3/mobile/check-ref/order-123');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Access-Token: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['success']) {
    echo "Statut: " . $result['data']['status'] . "\n";
    echo "Téléphone: " . $result['data']['MSSIDN'] . "\n";

    // Nouveau en v3 : informations de remboursement améliorées
    if ($result['data']['status'] === 'REFUNDED') {
        echo "❌ La recharge a été remboursée\n";
        echo "Raison: " . $result['data']['refund_message'] . "\n";
        if (isset($result['data']['suggested_offers'])) {
            echo "💡 Essayez ces offres à la place :\n";
            print_r($result['data']['suggested_offers']);
        }
    } elseif ($result['data']['status'] === 'FULFILLED') {
        echo "✅ Recharge complétée avec succès\n";
    }
}

response = requests.get(
    'https://api.oneclickdz.com/v3/mobile/check-ref/order-123',
    headers={'X-Access-Token': API_KEY}
)
result = response.json()

if result['success']:
    print(f"Statut: {result['data']['status']}")
    print(f"Téléphone: {result['data']['MSSIDN']}")

    # Nouveau en v3 : informations de remboursement améliorées
    if result['data']['status'] == 'REFUNDED':
        print("❌ La recharge a été remboursée")
        print(f"Raison: {result['data']['refund_message']}")
        if 'suggested_offers' in result['data']:
            print("💡 Essayez ces offres à la place :")
            print(result['data']['suggested_offers'])
    elif result['data']['status'] == 'FULFILLED':
        print("✅ Recharge complétée avec succès")

Exemple 4 : Lister les transactions avec pagination

Étape 1 - Votre code v2 actuel :

JavaScript
PHP
Python

const response = await fetch(
  "https://flexy-api.oneclickdz.com/v2/account/transactions?page=1&pageSize=20",
  {
    headers: { authorization: API_KEY },
  }
);

const data = await response.json();
console.log("Transactions:", data.transactions);
console.log("Total:", data.totalResults);
console.log("Page:", data.currentPage);
console.log("Pages:", data.totalPages);

$ch = curl_init('https://flexy-api.oneclickdz.com/v2/account/transactions?page=1&pageSize=20');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['authorization: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);

echo "Transactions: " . count($data['transactions']) . "\n";
echo "Total: " . $data['totalResults'] . "\n";
echo "Page: " . $data['currentPage'] . "\n";
echo "Pages: " . $data['totalPages'] . "\n";

response = requests.get(
    'https://flexy-api.oneclickdz.com/v2/account/transactions?page=1&pageSize=20',
    headers={'authorization': API_KEY}
)
data = response.json()

print(f"Transactions: {len(data['transactions'])}")
print(f"Total: {data['totalResults']}")
print(f"Page: {data['currentPage']}")
print(f"Pages: {data['totalPages']}")

Étape 2 - Ce qu’il faut changer :

Changer l’URL de base : https://flexy-api.oneclickdz.com → https://api.oneclickdz.com
Changer la version : /v2/account/transactions → /v3/account/transactions
Changer l’en-tête : authorization → X-Access-Token
Ajouter la vérification de succès : if (result.success)
Accéder aux éléments : data.transactions → result.data.items
Accéder à la pagination : Champs au niveau racine → objet result.data.pagination

Changement cassant : La structure de pagination a été déplacée du niveau racine vers data.pagination. Mettez à jour toute la logique de liste/pagination.

Étape 3 - Votre nouveau code v3 :

JavaScript
PHP
Python

const response = await fetch(
  "https://api.oneclickdz.com/v3/account/transactions?page=1&pageSize=20",
  {
    headers: { "X-Access-Token": API_KEY },
  }
);

const result = await response.json();
if (result.success) {
  console.log("Transactions:", result.data.items);
  console.log("Total:", result.data.pagination.totalResults);
  console.log("Page:", result.data.pagination.page);
  console.log("Pages:", result.data.pagination.totalPages);
  console.log("Taille de page:", result.data.pagination.pageSize);
}

$ch = curl_init('https://api.oneclickdz.com/v3/account/transactions?page=1&pageSize=20');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Access-Token: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['success']) {
    echo "Transactions: " . count($result['data']['items']) . "\n";
    echo "Total: " . $result['data']['pagination']['totalResults'] . "\n";
    echo "Page: " . $result['data']['pagination']['page'] . "\n";
    echo "Pages: " . $result['data']['pagination']['totalPages'] . "\n";
    echo "Taille de page: " . $result['data']['pagination']['pageSize'] . "\n";
}

response = requests.get(
    'https://api.oneclickdz.com/v3/account/transactions?page=1&pageSize=20',
    headers={'X-Access-Token': API_KEY}
)
result = response.json()

if result['success']:
    print(f"Transactions: {len(result['data']['items'])}")
    print(f"Total: {result['data']['pagination']['totalResults']}")
    print(f"Page: {result['data']['pagination']['page']}")
    print(f"Pages: {result['data']['pagination']['totalPages']}")
    print(f"Taille de page: {result['data']['pagination']['pageSize']}")

Exemple 5 : Vérifier les produits internet

Étape 1 - Votre code v2 actuel :

JavaScript
PHP
Python

const response = await fetch(
  "https://flexy-api.oneclickdz.com/v2/internet/checkCards/ADSL",
  {
    headers: { authorization: API_KEY },
  }
);

const cards = await response.json(); // Direct array
cards.forEach((card) => {
  console.log(`${card.value} DA - Disponible: ${card.available}`);
});

$ch = curl_init('https://flexy-api.oneclickdz.com/v2/internet/checkCards/ADSL');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['authorization: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$cards = json_decode($response, true); // Direct array

foreach ($cards as $card) {
    echo $card['value'] . " DA - Disponible: " . $card['available'] . "\n";
}

response = requests.get(
    'https://flexy-api.oneclickdz.com/v2/internet/checkCards/ADSL',
    headers={'authorization': API_KEY}
)
cards = response.json()  # Direct array

for card in cards:
    print(f"{card['value']} DA - Disponible: {card['available']}")

Étape 2 - Ce qu’il faut changer :

Changer l’URL de base : https://flexy-api.oneclickdz.com → https://api.oneclickdz.com
Changer l’endpoint : /v2/internet/checkCards/:type → /v3/internet/products?type=:type
Passer du param de chemin au param de requête : /ADSL → ?type=ADSL
Changer l’en-tête : authorization → X-Access-Token
Ajouter la vérification de succès : if (result.success)
Accéder au tableau : Tableau direct → result.data.products

Conception API : v3 utilise des paramètres de requête au lieu de paramètres de chemin pour la sélection du type, facilitant l’ajout de filtres à l’avenir.

Étape 3 - Votre nouveau code v3 :

JavaScript
PHP
Python

const response = await fetch(
  "https://api.oneclickdz.com/v3/internet/products?type=ADSL",
  {
    headers: { "X-Access-Token": API_KEY },
  }
);

const result = await response.json();
if (result.success) {
  result.data.products.forEach((card) => {
    console.log(`${card.value} DA - Disponible: ${card.available}`);
  });
}

$ch = curl_init('https://api.oneclickdz.com/v3/internet/products?type=ADSL');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Access-Token: ' . $apiKey]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['success']) {
    foreach ($result['data']['products'] as $card) {
        echo $card['value'] . " DA - Disponible: " . $card['available'] . "\n";
    }
}

response = requests.get(
    'https://api.oneclickdz.com/v3/internet/products?type=ADSL',
    headers={'X-Access-Token': API_KEY}
)
result = response.json()

if result['success']:
    for card in result['data']['products']:
        print(f"{card['value']} DA - Disponible: {card['available']}")

Migrer votre client API

Voici comment mettre à jour votre wrapper de client API : Étape 1 - Votre client v2 actuel :

JavaScript
PHP
Python

class FlexyAPI {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseUrl = "https://flexy-api.oneclickdz.com";
  }

  async request(endpoint, options = {}) {
    const response = await fetch(`${this.baseUrl}${endpoint}`, {
      ...options,
      headers: {
        ...options.headers,
        authorization: this.apiKey,
      },
    });
    return response.json();
  }

  async getBalance() {
    const data = await this.request("/v2/account/balance");
    return data.balance;
  }

  async sendTopup(params) {
    return await this.request("/v2/topup/sendTopup", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(params),
    });
  }
}

class FlexyAPI {
    private $apiKey;
    private $baseUrl = 'https://flexy-api.oneclickdz.com';

    public function __construct($apiKey) {
        $this->apiKey = $apiKey;
    }

    private function request($endpoint, $options = []) {
        $ch = curl_init($this->baseUrl . $endpoint);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'authorization: ' . $this->apiKey
        ]);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

        if (isset($options['method']) && $options['method'] === 'POST') {
            curl_setopt($ch, CURLOPT_POST, true);
            curl_setopt($ch, CURLOPT_POSTFIELDS, $options['body']);
        }

        $response = curl_exec($ch);
        return json_decode($response, true);
    }

    public function getBalance() {
        $data = $this->request('/v2/account/balance');
        return $data['balance'];
    }

    public function sendTopup($params) {
        return $this->request('/v2/topup/sendTopup', [
            'method' => 'POST',
            'body' => json_encode($params)
        ]);
    }
}

import requests

class FlexyAPI:
    def __init__(self, api_key):
        self.api_key = api_key
        self.base_url = 'https://flexy-api.oneclickdz.com'

    def request(self, endpoint, method='GET', data=None):
        headers = {'authorization': self.api_key}
        url = f"{self.base_url}{endpoint}"

        if method == 'GET':
            response = requests.get(url, headers=headers)
        else:
            headers['Content-Type'] = 'application/json'
            response = requests.post(url, headers=headers, json=data)

        return response.json()

    def get_balance(self):
        data = self.request('/v2/account/balance')
        return data['balance']

    def send_topup(self, params):
        return self.request('/v2/topup/sendTopup', method='POST', data=params)

Étape 2 - Ce qu’il faut changer :

Changer l’URL de base : https://flexy-api.oneclickdz.com → https://api.oneclickdz.com
Changer l’en-tête : authorization → X-Access-Token
Ajouter la gestion de l’encapsuleur de réponse dans la méthode request()
Vérifier result.success et gérer les erreurs
Mettre à jour tous les chemins d’endpoint vers v3
Lever des erreurs structurées avec des codes et des IDs de requête

Bonne pratique : Centralisez la gestion des erreurs dans votre client API. Cela facilite l’ajout de journalisation, de surveillance et de notifications utilisateur.

Étape 3 - Votre nouveau client v3 :

JavaScript
PHP
Python

class FlexyAPI {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseUrl = "https://api.oneclickdz.com";
  }

  async request(endpoint, options = {}) {
    const response = await fetch(`${this.baseUrl}${endpoint}`, {
      ...options,
      headers: {
        ...options.headers,
        "X-Access-Token": this.apiKey,
      },
    });

    const result = await response.json();

    if (!result.success) {
      const error = new Error(result.error.message);
      error.code = result.error.code;
      error.details = result.error.details;
      error.requestId = result.requestId;
      throw error;
    }

    return result.data;
  }

  async getBalance() {
    const data = await this.request("/v3/account/balance");
    return data.balance;
  }

  async sendTopup(params) {
    return await this.request("/v3/mobile/send", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(params),
    });
  }
}

class FlexyAPI {
    private $apiKey;
    private $baseUrl = 'https://api.oneclickdz.com';

    public function __construct($apiKey) {
        $this->apiKey = $apiKey;
    }

    private function request($endpoint, $options = []) {
        $ch = curl_init($this->baseUrl . $endpoint);
        $headers = ['X-Access-Token: ' . $this->apiKey];

        if (isset($options['method']) && $options['method'] === 'POST') {
            curl_setopt($ch, CURLOPT_POST, true);
            curl_setopt($ch, CURLOPT_POSTFIELDS, $options['body']);
            $headers[] = 'Content-Type: application/json';
        }

        curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        $response = curl_exec($ch);
        $result = json_decode($response, true);

        if (!$result['success']) {
            throw new Exception(json_encode([
                'message' => $result['error']['message'],
                'code' => $result['error']['code'],
                'details' => $result['error']['details'] ?? null,
                'requestId' => $result['requestId']
            ]));
        }

        return $result['data'];
    }

    public function getBalance() {
        $data = $this->request('/v3/account/balance');
        return $data['balance'];
    }

    public function sendTopup($params) {
        return $this->request('/v3/mobile/send', [
            'method' => 'POST',
            'body' => json_encode($params)
        ]);
    }
}

import requests

class FlexyAPIError(Exception):
    def __init__(self, message, code, details=None, request_id=None):
        super().__init__(message)
        self.code = code
        self.details = details
        self.request_id = request_id

class FlexyAPI:
    def __init__(self, api_key):
        self.api_key = api_key
        self.base_url = 'https://api.oneclickdz.com'

    def request(self, endpoint, method='GET', data=None):
        headers = {'X-Access-Token': self.api_key}
        url = f"{self.base_url}{endpoint}"

        if method == 'GET':
            response = requests.get(url, headers=headers)
        else:
            headers['Content-Type'] = 'application/json'
            response = requests.post(url, headers=headers, json=data)

        result = response.json()

        if not result['success']:
            raise FlexyAPIError(
                result['error']['message'],
                result['error']['code'],
                result['error'].get('details'),
                result['requestId']
            )

        return result['data']

    def get_balance(self):
        data = self.request('/v3/account/balance')
        return data['balance']

    def send_topup(self, params):
        return self.request('/v3/mobile/send', method='POST', data=params)

Référence des codes d’erreur

Erreurs v2 courantes et leurs équivalents v3 :

Erreur v2	Code d’erreur v3	Ce qui a changé
`"NO-BALANCE"`	`INSUFFICIENT_BALANCE`	Maintenant un code avec un message structuré
`"DUPLICATED-REF"`	`DUPLICATED_REF`	Même code, maintenant avec un objet details
`"ERR_VALIDATION"`	`ERR_VALIDATION`	Inclut `details.field` et `details.pattern`
`"ERR_PHONE"`	`ERR_PHONE`	Inclut le pattern de validation dans les détails
`"ERR_STOCK"`	`ERR_STOCK`	Informations sur la disponibilité du produit
`"Forbidden"`	`ERR_AUTH`	Plus descriptif, erreurs d’auth unifiées
`"Access token missing"`	`ERR_AUTH`	Même code pour toutes les erreurs d’auth
`"NOT_FOUND"`	`NOT_FOUND`	Ressource non trouvée (commande, produit, etc.)

Comment gérer les erreurs v3 :

JavaScript
PHP
Python

// Méthode v2 :
if (result.error === "NO-BALANCE") {
  // gérer
}

// Méthode v3 :
if (!result.success && result.error.code === "INSUFFICIENT_BALANCE") {
  console.log("Request ID:", result.requestId); // Sauvegarder pour le support
  if (result.error.details?.currentBalance) {
    console.log("Solde actuel:", result.error.details.currentBalance);
  }
}

// Méthode v2 :
if ($result['error'] === 'NO-BALANCE') {
    // gérer
}

// Méthode v3 :
if (!$result['success'] && $result['error']['code'] === 'INSUFFICIENT_BALANCE') {
    error_log("Request ID: " . $result['requestId']);
    if (isset($result['error']['details']['currentBalance'])) {
        echo "Solde actuel: " . $result['error']['details']['currentBalance'] . "\n";
    }
}

# Méthode v2 :
if result.get('error') == 'NO-BALANCE':
    # gérer

# Méthode v3 :
if not result['success'] and result['error']['code'] == 'INSUFFICIENT_BALANCE':
    print(f"Request ID: {result['requestId']}")
    if 'currentBalance' in result['error'].get('details', {}):
        print(f"Solde actuel: {result['error']['details']['currentBalance']}")

Délai critique : Après le 30 octobre 2026, toutes les requêtes API v2 échoueront. Planifiez votre migration en conséquence pour éviter toute interruption de service.

Problèmes de migration courants et solutions

Problème : Erreurs 401 Non autorisé

Problème : Endpoint changé mais nom de l’en-tête non mis à jour.Solution : Remplacez authorization par X-Access-Token dans TOUTES les requêtes.

// ❌ Incorrect
headers: { authorization: API_KEY }

// ✅ Correct
headers: { "X-Access-Token": API_KEY }

Problème : Obtenir 'undefined' en accédant aux données

Problème : Tentative d’accès direct aux données sans passer par result.data.Solution : Accédez toujours aux données de réponse via la propriété data.

// ❌ Incorrect
const balance = result.balance;

// ✅ Correct
const balance = result.data.balance;

Problème : La pagination ne fonctionne pas

Problème : Recherche des champs de pagination au niveau racine.Solution : Accédez à la pagination via data.pagination.

// ❌ Incorrect
const total = result.totalResults;
const page = result.currentPage;

// ✅ Correct
const total = result.data.pagination.totalResults;
const page = result.data.pagination.page;

Problème : La gestion des erreurs ne fonctionne pas

Problème : Vérification de l’ancien format d’erreur.Solution : Vérifiez le booléen success et accédez à l’objet d’erreur structuré.

// ❌ Incorrect
if (result.error) {
  console.log(result.message);
}

// ✅ Correct
if (!result.success) {
  console.log(result.error.code, result.error.message);
  console.log("Request ID:", result.requestId);
}

Problème : Erreurs 404 Non trouvé

Problème : Utilisation des anciens chemins d’endpoint v2.Solution : Mettez à jour tous les chemins selon le tableau de référence ci-dessus.

// ❌ Incorrect
POST /v2/topup/sendTopup
GET /v2/internet/checkCards/ADSL

// ✅ Correct
POST /v3/mobile/send
GET /v3/internet/products?type=ADSL

Référence complète des endpoints

Service	Endpoint v2	Endpoint v3	Notes
Authentification
En-tête	`authorization: KEY`	`X-Access-Token: KEY`	Nom de l’en-tête modifié
Valider	`GET /v2/validate`	`GET /v3/validate`	Réponse encapsulée
Mobile
Liste des forfaits	`GET /v2/plans/listAll`	`GET /v3/mobile/plans`	Chemin modifié, faute de frappe corrigée
Envoyer recharge	`POST /v2/topup/sendTopup`	`POST /v3/mobile/send`	Chemin simplifié
Vérifier par réf	`GET /v2/topup/checkStatus/REF/:ref`	`GET /v3/mobile/check-ref/:ref`	Chemin simplifié, infos remboursement ajoutées
Vérifier par ID	`GET /v2/topup/checkStatus/ID/:id`	`GET /v3/mobile/check-id/:id`	Chemin simplifié
Liste recharges	`GET /v2/topup/list`	`GET /v3/mobile/list`	Pagination déplacée vers `data.pagination`
Internet
Produits	`GET /v2/internet/checkCards/:type`	`GET /v3/internet/products?type=`	Param de chemin → param de requête
Vérifier numéro	`GET /v2/internet/checkNumber/:t/:n`	`GET /v3/internet/check-number?type=&number=`	Params de chemin → params de requête
Envoyer	`POST /v2/internet/sendTopup`	`POST /v3/internet/send`	Chemin simplifié
Vérifier par réf	`GET /v2/internet/checkStatus/REF/:ref`	`GET /v3/internet/check-ref/:ref`	Chemin simplifié
Vérifier par ID	`GET /v2/internet/checkStatus/ID/:id`	`GET /v3/internet/check-id/:id`	Chemin simplifié
Liste	`GET /v2/internet/list`	`GET /v3/internet/list`	Pagination déplacée
Cartes cadeaux
Catalogue	`GET /v2/gift-cards/catalogue`	`GET /v3/gift-cards/catalog`	Orthographe corrigée
Vérifier produit	`GET /v2/gift-cards/checkProduct/:id`	`GET /v3/gift-cards/checkProduct/:id`	Réponse encapsulée
Passer commande	`POST /v2/gift-cards/placeOrder`	`POST /v3/gift-cards/placeOrder`	Réponse encapsulée
Vérifier commande	`GET /v2/gift-cards/checkOrder/:id`	`GET /v3/gift-cards/checkOrder/:id`	Réponse encapsulée
Liste commandes	`GET /v2/gift-cards/list`	`GET /v3/gift-cards/list`	Pagination déplacée
Compte
Solde	`GET /v2/account/balance`	`GET /v3/account/balance`	Réponse encapsulée
Transactions	`GET /v2/account/transactions`	`GET /v3/account/transactions`	Pagination déplacée

Liste de vérification des tests

Avant de déployer en production, vérifiez :

Besoin d’aide ?

Documentation API v3

Référence complète v3 et exemples

Guide de gestion des erreurs

Bonnes pratiques pour la gestion des erreurs

Paramètres du tableau de bord

Accès : Connectez-vous à votre tableau de bordGénérer une clé sandbox : Créez une clé sandbox pour des tests sécurisésListe blanche d’IP : Ajoutez des restrictions IP pour une sécurité renforcée

Support

Email : [email protected]Important : Incluez toujours votre ID de requête lors du signalement de problèmes

Support à la migration : Notre équipe est là pour vous aider ! Envoyez-nous un e-mail avec “Support migration API v3” en objet, et incluez : - Les détails de votre implémentation actuelle - Les erreurs spécifiques (avec les IDs de requête) - Des exemples de code illustrant le problème

Démarrage

Guides avancés

Vue d’ensemble

Nouveautés de v3

Réponses standardisées

Meilleure gestion des erreurs

Débogage amélioré

Endpoints plus clairs

Clés API séparées

Liste blanche d'IP

Liste de contrôle de migration rapide

Choisissez votre stratégie de migration

🆕 Nouveau départ

🔄 Migration progressive

Migration intelligente : Commencez par les cartes cadeaux

Les 3 changements principaux

1. En-tête d’authentification

2. Structure des réponses

3. Gestion des erreurs

Exemples de migration étape par étape

Exemple 1 : Récupérer les forfaits mobiles

Exemple 2 : Envoyer une recharge mobile

Exemple 3 : Vérifier le statut d’une recharge

Exemple 5 : Vérifier les produits internet

Migrer votre client API

Référence des codes d’erreur

Problèmes de migration courants et solutions

Référence complète des endpoints

Liste de vérification des tests

Besoin d’aide ?

Documentation API v3

Guide de gestion des erreurs

Paramètres du tableau de bord

Support

Démarrage

Guides avancés

Documentation Index

​Vue d’ensemble

​Nouveautés de v3

Réponses standardisées

Meilleure gestion des erreurs

Débogage amélioré

Endpoints plus clairs

Clés API séparées

Liste blanche d'IP

​Liste de contrôle de migration rapide

​Choisissez votre stratégie de migration

🆕 Nouveau départ

🔄 Migration progressive

​Migration intelligente : Commencez par les cartes cadeaux

​Les 3 changements principaux

​1. En-tête d’authentification

​2. Structure des réponses

​3. Gestion des erreurs

​Exemples de migration étape par étape

​Exemple 1 : Récupérer les forfaits mobiles

​Exemple 2 : Envoyer une recharge mobile

​Exemple 3 : Vérifier le statut d’une recharge

​Exemple 4 : Lister les transactions avec pagination

​Exemple 5 : Vérifier les produits internet

​Migrer votre client API

​Référence des codes d’erreur

​Problèmes de migration courants et solutions

​Référence complète des endpoints

​Liste de vérification des tests

​Besoin d’aide ?

Documentation API v3

Guide de gestion des erreurs

Paramètres du tableau de bord

Support

Vue d’ensemble

Nouveautés de v3

Liste de contrôle de migration rapide

Choisissez votre stratégie de migration

Migration intelligente : Commencez par les cartes cadeaux

Les 3 changements principaux

1. En-tête d’authentification

2. Structure des réponses

3. Gestion des erreurs

Exemples de migration étape par étape

Exemple 1 : Récupérer les forfaits mobiles

Exemple 2 : Envoyer une recharge mobile

Exemple 3 : Vérifier le statut d’une recharge

Exemple 4 : Lister les transactions avec pagination

Exemple 5 : Vérifier les produits internet

Migrer votre client API

Référence des codes d’erreur

Problèmes de migration courants et solutions

Référence complète des endpoints

Liste de vérification des tests

Besoin d’aide ?