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

# API Crédits

> Documentation de l'API pour la récupération du nombre de crédits disponibles

# API Crédits

Cette API vous permet de récupérer le nombre total de crédits disponibles sur votre compte, incluant les crédits liés à votre abonnement et les crédits supplémentaires.

## Authentification (obligatoire)

Depuis la migration vers l'App Router, l'authentification est **obligatoire** pour cet endpoint :

* **Header `x-api-key`** : Votre clé API (générée dans l'Espace Développeur)
* **Corps de requête `user_id`** : L'identifiant utilisateur associé à cette clé API

La clé API doit correspondre à l'utilisateur dans votre abonnement Home Staging. En cas d'absence ou d'invalidité de la clé, une erreur **401 Unauthorized** sera retournée.

## Récupérer ses crédits

<ParamField path="POST /api/account/credit" />

Ce endpoint vous permet d'obtenir les informations détaillées sur vos crédits disponibles.

### Paramètres de la requête

<ParamField body="user_id" type="string" required>
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

### Réponse

<ResponseField name="total" type="number">
  Le nombre total de crédits disponibles sur votre compte
</ResponseField>

<ResponseField name="subscription" type="number">
  Le nombre de crédits issus de votre abonnement
</ResponseField>

<ResponseField name="extra" type="number">
  Le nombre de crédits supplémentaires achetés séparément
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/account/credit' \
--header x-api-key:API_KEY \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid"
}'
```

### Exemple de réponse

```json theme={null}
{
  "total": 100,
  "subscription": 90,
  "extra": 10
}
```

### Codes d'erreur

| Code | Description                                               |
| ---- | --------------------------------------------------------- |
| 400  | Paramètres invalides (ex: `user_id` manquant ou invalide) |
| 401  | Clé API manquante ou invalide (header `x-api-key` requis) |
| 503  | Service temporairement indisponible                       |