> ## 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.

# Santé et vérification

> Endpoints de vérification de l'état du service et de la clé API - tous deux gratuits et sans consommation de crédits.

Deux endpoints utilitaires qui ne coûtent **aucun crédit** et sont disponibles pour tous les forfaits.

## Vérification de l'état du service

`GET /health` - retourne l'état actuel du service. Aucune authentification requise.

```bash theme={null}
curl https://api.responsibleailabs.ai/health
```

```json theme={null}
{
  "status": "healthy",
  "service": "rail-score-engine"
}
```

<ResponseField name="status" type="string">
  `"healthy"` lorsque le service est pleinement opérationnel. Utilisez cet endpoint pour la surveillance de la disponibilité et les sondes de santé des répartiteurs de charge.
</ResponseField>

<ResponseField name="service" type="string">
  Toujours `"rail-score-engine"`.
</ResponseField>

## Vérification de la clé

`POST /verify` - vérifie qu'une clé API est valide et active. Retourne le forfait et les crédits restants associés à la clé.

```bash theme={null}
curl -X POST https://api.responsibleailabs.ai/verify \
  -H "Authorization: Bearer YOUR_RAIL_API_KEY"
```

```json theme={null}
{
  "valid": true,
  "plan": "pro",
  "credits_remaining": 847.5
}
```

<ResponseField name="valid" type="boolean">
  `true` si la clé est active et autorisée. `false` si la clé est révoquée ou n'existe pas.
</ResponseField>

<ResponseField name="plan" type="string">
  Le forfait associé à cette clé : `"free"`, `"pro"`, `"business"` ou `"enterprise"`.
</ResponseField>

<ResponseField name="credits_remaining" type="number">
  Solde de crédits restant pour la période mensuelle en cours.
</ResponseField>

## Réponses d'erreur

| Status | Signification                                                               |
| ------ | --------------------------------------------------------------------------- |
| `401`  | Header `Authorization` manquant ou invalide                                 |
| `403`  | Clé révoquée ou inactive                                                    |
| `503`  | Service temporairement indisponible - réessayez avec un backoff exponentiel |

## Utilisation dans les SDK

<CodeGroup>
  ```python Python theme={null}
  from rail_score_sdk import RailScoreClient

  client = RailScoreClient(api_key="YOUR_RAIL_API_KEY")

  # Check health
  health = client.health()
  print(health.status)  # "healthy"

  # Verify key
  info = client.verify()
  print(info.valid)              # True
  print(info.plan)               # "pro"
  print(info.credits_remaining)  # 847.5
  ```

  ```typescript JavaScript theme={null}
  import { RailScoreClient } from "@responsible-ai-labs/rail-score";

  const client = new RailScoreClient({ apiKey: "YOUR_RAIL_API_KEY" });

  const health = await client.health();
  console.log(health.status); // "healthy"

  const info = await client.verify();
  console.log(info.creditsRemaining); // 847.5
  ```
</CodeGroup>

## Pour aller plus loin

<CardGroup cols={2}>
  <Card title="Authentification" icon="key" href="/getting-started/authentication">
    Comment générer et gérer vos clés API.
  </Card>

  <Card title="Crédits et tarification" icon="coins" href="/getting-started/credits">
    Coûts en crédits de chaque endpoint et allocations par forfait.
  </Card>
</CardGroup>