Passer au contenu principal
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.
curl https://api.responsibleailabs.ai/health
{
  "status": "healthy",
  "service": "rail-score-engine"
}
status
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.
service
string
Toujours "rail-score-engine".

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é.
curl -X POST https://api.responsibleailabs.ai/verify \
  -H "Authorization: Bearer YOUR_RAIL_API_KEY"
{
  "valid": true,
  "plan": "pro",
  "credits_remaining": 847.5
}
valid
boolean
true si la clé est active et autorisée. false si la clé est révoquée ou n’existe pas.
plan
string
Le forfait associé à cette clé : "free", "pro", "business" ou "enterprise".
credits_remaining
number
Solde de crédits restant pour la période mensuelle en cours.

Réponses d’erreur

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

Utilisation dans les SDK

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

Pour aller plus loin

Authentification

Comment générer et gérer vos clés API.

Crédits et tarification

Coûts en crédits de chaque endpoint et allocations par forfait.