Passer au contenu principal

​
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

​
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

​
user_id
string
requis
L’identifiant unique de l’utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur

​
Réponse

​
total
number
Le nombre total de crédits disponibles sur votre compte
​
subscription
number
Le nombre de crédits issus de votre abonnement
​
extra
number
Le nombre de crédits supplémentaires achetés séparément

​
Exemple de requête

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

{
  "total": 100,
  "subscription": 90,
  "extra": 10
}

​
Codes d’erreur

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