Felo API PlatformFelo API Platform

Handleidingen

Data API-overzicht

Roep endpoints van derden aan via één gedeeld voorvoegsel, met consistente authenticatie en aanvraagafhandeling.

De Data API is een catalogus van API's van derden achter één Felo-sleutel. De API staat los van de eigen /v2-API's van Felo en van de Model API.

Gedeeld voorvoegsel

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

De referentie toont elk endpoint als een volledig pad dat begint met /v1/beta. Gebruik dat pad ongewijzigd op de host; zet het gedeelde voorvoegsel er niet nog eens voor. Het zoekendpoint van Tavily is bijvoorbeeld:

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

Een endpoint vinden

  • Blader door de API-directory op leverancier.
  • Open de Data API-referentie voor de volledige lijst met endpoints, parameters en responsschema's.
  • Gebruik de tags in de referentie om tussen leveranciers te wisselen.

Elke leverancier behoudt zijn eigen vorm van het verzoek. De gedeelde laag standaardiseert authenticatie en routering, niet de payload. Lees het schema van het endpoint voordat je een verzoek verstuurt.

Authenticatie

Gebruik een van deze headers:

Authorization: Bearer $FELO_API_KEY

of:

X-API-Key: $FELO_API_KEY

Stuur Content-Type: application/json mee voor JSON-bodies.

Voorbeeldverzoek

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
  }'

De vorm van de respons komt van de leverancier. Velden zoals resultaten, paginacursors en metadata worden niet genormaliseerd tussen providers.

Conventies

OnderwerpWat je kunt verwachten
PayloadLeveranciersspecifieke JSON; volg het schema van het endpoint
PagineringVeldnamen en cursorstijlen verschillen per endpoint
FoutenJSON met status, code, message en request_id; details van de provider kunnen in het bericht staan
Rate limitsSpecifiek per endpoint en leverancier; reken op 429 onder belasting
FactureringPer aanroep, uit hetzelfde service-tegoedsaldo als de Model API

Fouten afhandelen

Een authenticatiefout retourneert hetzelfde foutformaat als de rest van het platform:

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

Lees bij een fout op providerniveau de HTTP-status en het bericht. Log de methode, het volledige pad, de vorm van de verzoekbody en request_id. Log nooit de volledige API-sleutel.

Nieuwe pogingen

Probeer 429- en 5xx-responsen opnieuw met backoff. Probeer 400 of 401 niet ongewijzigd opnieuw. Sommige bewerkingen van providers zijn niet veilig om te herhalen; controleer het endpoint voordat je een schrijfactie opnieuw probeert.

Wanneer je beter een Felo API gebruikt

Gebruik de Data API als je een specifieke databron van een derde nodig hebt. Gebruik een Felo API als je de eigen workflow van Felo wilt:

Gerelateerd