Passer au contenu principal

URL de base

https://app.orova.ai/api
Tous les points de terminaison de l’API sont préfixés par /api.

Authentification

Toutes les requêtes API nécessitent une clé API dans l’en-tête x-api-key. Générez-en une depuis le tableau de bord Orova.
curl https://app.orova.ai/api/agents \
  -H "x-api-key: YOUR_API_KEY"
Consultez Authentification pour plus de détails.

Format de réponse

Toutes les réponses sont au format JSON. Les réponses réussies renvoient directement les données. Les erreurs renvoient :
{
  "statusCode": 400,
  "message": "Error description",
  "error": "Bad Request"
}

Codes de statut courants

CodeDescription
200Succès
201Créé
400Requête incorrecte — vérifiez vos paramètres
401Non autorisé — clé API invalide ou manquante
402Paiement requis — crédits insuffisants
403Interdit — pas d’accès à cette ressource
404Introuvable
500Erreur serveur

Pagination

Les points de terminaison de liste prennent en charge la pagination :
ParamètrePar défautDescription
page1Numéro de page
limit10Éléments par page (le maximum varie selon le point de terminaison)

Limites de débit

Les requêtes API ne sont pas actuellement limitées en débit, mais nous recommandons de maintenir les requêtes en dessous de 100/minute par clé API.