Felo API PlatformFelo API Platform

Guides

Vue d'ensemble de Data API

Appelez des endpoints tiers via un préfixe commun, avec une authentification et un traitement des requêtes cohérents.

Le Data API est un catalogue d'API tierces derrière une seule clé Felo. Il est distinct des API /v2 propres à Felo et du Model API.

Préfixe commun

https://openapi.felo.ai/v1/beta

La référence présente chaque endpoint comme un chemin complet commençant par /v1/beta. Utilisez ce chemin tel quel sur l'hôte ; n'ajoutez pas à nouveau le préfixe commun. Par exemple, l'endpoint de recherche Tavily est :

POST https://openapi.felo.ai/v1/beta/tavily/search

Trouver un endpoint

  • Parcourez le répertoire des API par fournisseur.
  • Ouvrez la référence Data API pour la liste complète des endpoints, les paramètres et les schémas de réponse.
  • Utilisez les tags de la référence pour passer d'un fournisseur à l'autre.

Chaque fournisseur conserve sa propre forme de requête. La couche commune standardise l'authentification et le routage, pas la charge utile. Lisez le schéma de l'endpoint avant d'envoyer une requête.

Authentification

Utilisez l'un ou l'autre de ces en-têtes :

Authorization: Bearer $FELO_API_KEY

ou :

X-API-Key: $FELO_API_KEY

Envoyez Content-Type: application/json pour les corps JSON.

Exemple de requête

curl https://openapi.felo.ai/v1/beta/tavily/search \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What is Felo AI?",
    "max_results": 3
  }'

La forme de la réponse vient du fournisseur. Les champs tels que les résultats, les curseurs de pagination et les métadonnées ne sont pas normalisés entre fournisseurs.

Conventions

SujetÀ quoi s'attendre
Charge utileJSON propre au fournisseur ; suivez le schéma de l'endpoint
PaginationLes noms de champs et les styles de curseur varient selon l'endpoint
ErreursJSON avec status, code, message et request_id ; les détails du fournisseur peuvent apparaître dans le message
Limites de débitPropres à l'endpoint et au fournisseur ; attendez-vous à des 429 sous charge
FacturationPar appel, depuis le même solde de crédits de service que le Model API

Gestion des erreurs

Un échec d'authentification renvoie la même enveloppe que le reste de la plateforme :

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "Invalid API Key",
  "request_id": "..."
}

Pour un échec au niveau du fournisseur, lisez le statut HTTP et le message. Journalisez la méthode, le chemin complet, la forme du corps de requête et le request_id. Ne journalisez pas la clé API complète.

Nouvelles tentatives

Réessayez les réponses 429 et 5xx avec un backoff. Ne réessayez pas 400 ou 401 à l'identique. Certaines opérations de fournisseur ne sont pas sûres à répéter ; vérifiez l'endpoint avant de réessayer une écriture.

Quand utiliser plutôt une API Felo

Utilisez le Data API lorsque vous avez besoin d'une source de données tierce spécifique. Utilisez une API Felo lorsque vous voulez le workflow propre à Felo :

Voir aussi