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

# Vue d'ensemble de l'API

> Référence de l'API REST Orova

## URL de base

```
https://app.orova.ai/api
```

Tous les points de terminaison de l'API sont préfixés par `/api`.

## Authentification

Toutes les requêtes API nécessitent une clé API dans l'en-tête `x-api-key`. Générez-en une depuis le [tableau de bord Orova](https://app.orova.ai).

```bash theme={null}
curl https://app.orova.ai/api/agents \
  -H "x-api-key: YOUR_API_KEY"
```

Consultez [Authentification](/fr/api-reference/authentication) pour plus de détails.

## Format de réponse

Toutes les réponses sont au format JSON. Les réponses réussies renvoient directement les données. Les erreurs renvoient :

```json theme={null}
{
  "statusCode": 400,
  "message": "Error description",
  "error": "Bad Request"
}
```

## Codes de statut courants

| Code  | Description                                  |
| ----- | -------------------------------------------- |
| `200` | Succès                                       |
| `201` | Créé                                         |
| `400` | Requête incorrecte — vérifiez vos paramètres |
| `401` | Non autorisé — clé API invalide ou manquante |
| `402` | Paiement requis — crédits insuffisants       |
| `403` | Interdit — pas d'accès à cette ressource     |
| `404` | Introuvable                                  |
| `500` | Erreur serveur                               |

## Pagination

Les points de terminaison de liste prennent en charge la pagination :

| Paramètre | Par défaut | Description                                                        |
| --------- | ---------- | ------------------------------------------------------------------ |
| `page`    | `1`        | Numéro de page                                                     |
| `limit`   | `10`       | Éléments par page (le maximum varie selon le point de terminaison) |

## Limites de débit

Les requêtes API ne sont pas actuellement limitées en débit, mais nous recommandons de maintenir les requêtes en dessous de 100/minute par clé API.