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

# Introduction

> Guide de démarrage pour l'API Yabetoo.

L'API Yabetoo est organisée autour des principes REST. Notre API utilise des endpoints prévisibles avec des ressources orientées URL, accepte des requêtes JSON encodées en form-data, renvoie des réponses JSON encodées, et utilise les codes de statut HTTP standard.

## Base URL

```bash theme={null}
https://pay.api.yabetoopay.com    # Production
https://pay.sandbox.yabetoopay.com # Sandbox
```

## Authentication

L'API Yabetoo utilise des clés API pour authentifier les requêtes. Vous pouvez gérer vos clés API dans le [tableau de bord](https://app.yabetoo.com/developers).

Toutes les requêtes API doivent être effectuées via HTTPS et doivent inclure votre clé API dans l'en-tête Authorization :

```bash theme={null}
Authorization: Bearer sk_test_XXXXXXXXXXXXXXXXXXXXXXXX
```

## Formats de requête

### Content-Type

Pour les requêtes POST et PUT, le corps doit être encodé en JSON avec l'en-tête :

```bash theme={null}
Content-Type: application/json
```

### Paramètres de pagination

Pour les endpoints qui renvoient des listes, utilisez ces paramètres :

* `limit` : Nombre d'éléments par page (défaut : 10, max : 100)
* `page` : Numéro de la page (commence à 1)

## Réponses

### Structure

Toutes les réponses sont en JSON avec cette structure :

```json theme={null}
{
  "status": "success",
  "data": {
    // Les données de la réponse
  },
  "message": "Description optionnelle"
}
```

### Codes HTTP

* `200` : Succès
* `201` : Ressource créée
* `400` : Requête invalide
* `401` : Non authentifié
* `403` : Non autorisé
* `404` : Ressource non trouvée
* `429` : Trop de requêtes
* `500` : Erreur serveur

## Gestion des erreurs

En cas d'erreur, vous recevrez :

```json theme={null}
{
  "status": "error",
  "error": {
    "code": "invalid_request",
    "message": "Description de l'erreur",
    "details": {
      // Détails supplémentaires si disponibles
    }
  }
}
```

<Note>
  Conservez vos clés API en sécurité. Ne les partagez jamais publiquement ou dans
  le code client.
</Note>