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

# Référence API - Vue d'ensemble

> URL de base, authentification et liste complète des endpoints de l'API RAIL Score.

## URL de base

```
https://api.responsibleailabs.ai
```

## Authentification

Tous les endpoints (sauf `/health`) nécessitent un Bearer token :

```
Authorization: Bearer YOUR_RAIL_API_KEY
```

Les clés commencent par `rail_`. Générez la vôtre depuis le [tableau de bord](https://responsibleailabs.ai/dashboard).

## Endpoints

| Méthode | Endpoint                               | Description                                                             |
| ------- | -------------------------------------- | ----------------------------------------------------------------------- |
| `POST`  | `/railscore/v1/eval`                   | Évaluer du contenu selon les 8 dimensions RAIL                          |
| `POST`  | `/railscore/v1/safe-regenerate`        | Évaluer et régénérer jusqu'à atteindre le seuil                         |
| `POST`  | `/railscore/v1/compliance/check`       | Vérification de conformité réglementaire                                |
| `POST`  | `/railscore/v1/agent/tool-call`        | Évaluer un appel d'outil d'agent avant exécution                        |
| `POST`  | `/railscore/v1/agent/tool-result`      | Analyser le résultat d'un outil pour détecter les PII et les injections |
| `POST`  | `/railscore/v1/agent/prompt-injection` | Détecter les injections de prompt dans un texte                         |
| `GET`   | `/railscore/v1/config`                 | Lire la politique et la configuration de votre application              |
| `GET`   | `/railscore/v1/dimensions`             | Les dimensions RAIL et vos pondérations/seuils                          |
| `GET`   | `/railscore/v1/capabilities`           | Fonctionnalités et limites de votre forfait                             |
| `POST`  | `/verify`                              | Vérifier une clé API et consulter l'identité                            |
| `GET`   | `/health`                              | Vérification de l'état du service                                       |

## Codes d'erreur

| Status | Signification                                  |
| ------ | ---------------------------------------------- |
| `400`  | Requête invalide - vérifiez les paramètres     |
| `401`  | Clé API manquante ou invalide                  |
| `402`  | Crédits insuffisants                           |
| `403`  | Clé révoquée ou restriction de forfait         |
| `422`  | Erreur de validation - contenu trop court/long |
| `429`  | Limite de débit dépassée                       |
| `503`  | Service temporairement indisponible            |

Toutes les réponses d'erreur incluent un corps JSON :

```json theme={null}
{
  "error": {
    "code": "insufficient_credits",
    "message": "Requires 3.0 credits, balance is 1.5",
    "required": 3.0,
    "balance": 1.5
  }
}
```