> ## Documentation Index
> Fetch the complete documentation index at: https://developers.ligdicash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentification

> Comment authentifier vos requêtes vers l'API LigdiCash avec les en-têtes Apikey et Authorization.

Chaque requête vers l'API LigdiCash doit être accompagnée de deux clés d'identification, transmises dans les en-têtes HTTP. Ces clés sont disponibles dans votre dashboard LigdiCash une fois votre projet activé.

## Les deux clés

| En-tête         | Valeur               | Rôle                   |
| --------------- | -------------------- | ---------------------- |
| `Apikey`        | Votre clé API        | Identifie votre projet |
| `Authorization` | `Bearer {API_TOKEN}` | Authentifie la requête |

Ces deux clés sont distinctes et toutes les deux obligatoires. Une requête avec une seule des deux sera rejetée.

<Note>
  Une fois votre projet activé, vos clés `Apikey` et `API_TOKEN` sont disponibles directement dans votre dashboard LigdiCash.
</Note>

## En-têtes complets

Toutes vos requêtes doivent inclure ces quatre en-têtes :

```
Apikey: {API_KEY}
Authorization: Bearer {API_TOKEN}
Accept: application/json
Content-Type: application/json
```

## Exemple cURL

```bash cURL theme={null}
curl -X POST https://app.ligdicash.com/pay/v01/redirect/checkout-invoice/create \
  -H "Apikey: {API_KEY}" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{ ... }'
```

## Bonnes pratiques

**Stockez vos clés dans des variables d'environnement**, jamais en dur dans le code source :

<CodeGroup>
  ```bash .env theme={null}
  LIGDICASH_API_KEY=votre_api_key
  LIGDICASH_API_TOKEN=votre_api_token
  ```

  ```javascript Node.js theme={null}
  const apiKey = process.env.LIGDICASH_API_KEY;
  const apiToken = process.env.LIGDICASH_API_TOKEN;
  ```

  ```php PHP theme={null}
  $apiKey = getenv('LIGDICASH_API_KEY');
  $apiToken = getenv('LIGDICASH_API_TOKEN');
  ```

  ```python Python theme={null}
  import os
  api_key = os.environ["LIGDICASH_API_KEY"]
  api_token = os.environ["LIGDICASH_API_TOKEN"]
  ```
</CodeGroup>

<Warning>
  Ne transmettez jamais vos clés depuis un navigateur ou une application mobile. Tout appel à l'API LigdiCash doit transiter par votre serveur backend.
</Warning>

## Erreurs d'authentification

Une erreur d'authentification se manifeste par `response_code: "01"` et `response_text: "Echec (Code00)"` :

```json theme={null}
{
  "response_code": "01",
  "token": "",
  "response_text": "Echec (Code00)",
  "description": "",
  "wiki": "https://client.ligdicash.com/wiki/createInvoice"
}
```

Causes possibles :

* `Apikey` incorrecte ou expiré
* `API_TOKEN` incorrect ou expiré
* Un ou plusieurs en-têtes obligatoires absents

Le champ `wiki` présent dans chaque réponse contient une URL vers la documentation des codes d'erreur spécifique à l'endpoint appelé. **Consultez toujours cette URL** pour obtenir la signification exacte du code retourné — c'est la référence officielle LigdiCash pour interpréter `response_text`.

## Régénérer vos clés

Si vos clés sont compromises, contactez l'équipe LigdiCash pour en obtenir de nouvelles. Les anciennes clés sont immédiatement invalidées à la réémission.

<Warning>
  Toute réémission de clés interrompt immédiatement les appels en production. Préparez vos nouvelles variables d'environnement avant de demander la réémission.
</Warning>