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

# Introduction

> La référence décrit chaque route de la v1, avec « Essayer » contre la sandbox et des exemples en cURL, Node.js, Python, PHP et Java.

## Adresses

| Environnement | Adresse |
| :- | :- |
| Sandbox | `https://sandbox.umeme.app/v1` |
| Production | `https://api.umeme.app/v1` |

Les exemples de chaque route lisent l'adresse dans `UMEME_BASE_URL` et la clé dans `UMEME_CLE` : voir [Démarrer](https://docs.umeme.app/demarrer.md).

## Authentification

Chaque route, sauf la clé publique, exige l'en-tête `Authorization: Bearer <clé>`. Une clé porte des portées :

| Portée | Routes |
| :- | :- |
| `ventes:ecrire` | Créer une vente, renvoyer un rappel |
| `ventes:lire` | Consulter une vente |
| `compteurs:lire` | Vérifier un compteur |
| `portefeuille:lire` | Solde, mouvements |

Pour « Essayer », collez votre clé `umeme_test_` : la requête part vers la sandbox.

## Format des erreurs

```json Erreur {2} theme={"dark"}
{
  "code": "CLE_INVALIDE",
  "message": "La clé est absente ou inconnue."
}
```

Le `code` est stable ; le `message` peut changer. Voir [Codes d'erreur](https://docs.umeme.app/ressources/codes-erreur.md).

## Document OpenAPI

La sandbox sert le contrat sur `https://sandbox.umeme.app/v1/openapi.json`. La [collection Postman](https://docs.umeme.app/guides/postman.md) en est tirée.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.