> ## 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.

# Journal des modifications

> Mises à jour de l'API et changements majeurs

## v3.0.0 - Octobre 2025

<Warning>
  **Changements majeurs** : v3 est une refonte complète. Consultez le [Guide de migration](/fr/migration-from-v2) pour les instructions de mise à niveau.
</Warning>

### 🔴 Ce que vous devez modifier

<AccordionGroup>
  <Accordion icon="globe" title="1. URL de base modifiée" defaultOpen>
    ```diff theme={null}
    - https://flexy-api.oneclickdz.com/v2
    + https://api.oneclickdz.com/v3
    ```
  </Accordion>

  <Accordion icon="key" title="2. En-tête d'authentification modifié" defaultOpen>
    ```diff theme={null}
    - Authorization: your-api-key
    + X-Access-Token: your-api-key
    ```
  </Accordion>

  <Accordion icon="code" title="3. Structure de réponse modifiée" defaultOpen>
    Toutes les réponses sont maintenant encapsulées dans un format standardisé :

    **Avant (v2) :**

    ```json theme={null}
    {
      "balance": 50000,
      "currency": "DZD"
    }
    ```

    **Après (v3) :**

    ```json theme={null}
    {
      "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.
  </Accordion>

  <Accordion icon="route" title="4. Chemins des endpoints modifiés" defaultOpen>
    | Endpoint v2           | Endpoint 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`   |
  </Accordion>

  <Accordion icon="triangle-exclamation" title="5. Gestion des erreurs modifiée" defaultOpen>
    **Avant (v2) :**

    ```json theme={null}
    {
      "error": "Insufficient balance"
    }
    ```

    **Après (v3) :**

    ```json theme={null}
    {
      "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.
  </Accordion>
</AccordionGroup>

### ✨ 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

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

### 🔗 Ressources

* [Guide de migration complet](/fr/migration-from-v2)
* [Référence API v3](/fr/api-reference/response-format)
* [Guide d'authentification](/fr/authentication)

***

## 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 ?

<Card title="Contacter le support" icon="headset" href="/fr/contact">
  Des questions sur la migration ? Nous sommes là pour vous aider.
</Card>