Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.oneclickdz.com/llms.txt

Use this file to discover all available pages before exploring further.

​
v3.0.0 - Octobre 2025

Changements majeurs : v3 est une refonte complète. Consultez le Guide de migration pour les instructions de mise à niveau.

​
🔴 Ce que vous devez modifier

1. URL de base modifiée

- https://flexy-api.oneclickdz.com/v2
+ https://api.oneclickdz.com/v3

2. En-tête d'authentification modifié

- Authorization: your-api-key
+ X-Access-Token: your-api-key

3. Structure de réponse modifiée

Toutes les réponses sont maintenant encapsulées dans un format standardisé :Avant (v2) :
{
  "balance": 50000,
  "currency": "DZD"
}
Après (v3) :
{
  "success": true,
  "data": {
    "balance": 50000,
    "currency": "DZD"
  },
  "meta": {
    "timestamp": "2025-10-29T00:00:00.000Z"
  },
  "requestId": "req_abc123"
}
Accédez aux données via response.data au lieu d’y accéder directement depuis la réponse.

4. Chemins des endpoints modifiés

Endpoint v2Endpoint v3
/topup/plans/mobile/plans
/topup/send/mobile/send
/topup/check/:id/mobile/check/:id
/plans/internet/internet/products
/topup/sendInternet/internet/send
/account/info/account/balance

5. Gestion des erreurs modifiée

Avant (v2) :
{
  "error": "Insufficient balance"
}
Après (v3) :
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Your balance is insufficient for this operation",
    "details": {
      "required": 1000,
      "available": 500
    }
  },
  "requestId": "req_abc123"
}
Vérifiez toujours le booléen response.success en premier.

​
✨ Nouveautés

  • API Cartes cadeaux : Système complet de livraison de cartes cadeaux avec plus de 100 produits
  • Clés sandbox : Clés API séparées pour les tests sans impact sur le solde de production
  • Liste blanche d’IP : Sécurité renforcée via les paramètres du tableau de bord
  • Suivi des requêtes : Chaque requête inclut un requestId unique pour le débogage
  • Meilleures erreurs : Codes d’erreur structurés avec des messages exploitables
  • Validation du schéma : La validation automatique empêche les requêtes invalides

​
📅 Date limite de migration

v2 sera dépréciée le 30 octobre 2026. Migrez avant cette date pour éviter toute interruption de service.

​
🔗 Ressources

​
v2.x - Avant octobre 2025

​
Août 2025

  • Ajout du mode sandbox pour les tests
  • Amélioration de la gestion des erreurs et des journaux

​
Juillet 2023

  • Implémentation initiale du sandbox
  • Ajout du support pour la recharge internet ADSL

​
Antérieur

  • Recharges mobiles pour Mobilis, Djezzy, Ooredoo
  • Suivi de base des transactions
  • Gestion du solde du compte

​
Besoin d’aide ?

Contacter le support

Des questions sur la migration ? Nous sommes là pour vous aider.