Felo API PlatformFelo API Platform

Leitfäden

Data API-Übersicht

Rufen Sie Endpoints von Drittanbietern über ein gemeinsames Präfix auf, mit einheitlicher Authentifizierung und Anfrageverarbeitung.

Die Data API ist ein Katalog von Drittanbieter-APIs hinter einem Felo-Schlüssel. Sie ist von den eigenen /v2-APIs von Felo und von der Model API getrennt.

Gemeinsames Präfix

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

Die Referenz zeigt jeden Endpoint als vollständigen Pfad, der mit /v1/beta beginnt. Verwenden Sie diesen Pfad unverändert auf dem Host; stellen Sie das gemeinsame Präfix nicht erneut voran. Der Tavily-Suche-Endpoint lautet zum Beispiel:

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

Endpoint finden

  • Durchsuchen Sie das API-Verzeichnis nach Anbieter.
  • Öffnen Sie die Data API-Referenz für die vollständige Endpoint-Liste, Parameter und Antwortschemata.
  • Wechseln Sie mit den Tags der Referenz zwischen Anbietern.

Jeder Anbieter behält seine eigene Anfrageform bei. Die gemeinsame Ebene vereinheitlicht Authentifizierung und Routing, nicht den Payload. Lesen Sie das Endpoint-Schema, bevor Sie eine Anfrage senden.

Authentifizierung

Verwenden Sie einen der beiden Header:

Authorization: Bearer $FELO_API_KEY

oder:

X-API-Key: $FELO_API_KEY

Senden Sie Content-Type: application/json für JSON-Textkörper.

Beispielanfrage

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

Die Form der Antwort stammt vom Anbieter. Felder wie Ergebnisse, Paginierungs-Cursors und Metadaten werden nicht über alle Anbieter hinweg vereinheitlicht.

Konventionen

ThemaWas Sie erwarten können
PayloadAnbieterspezifisches JSON; folgen Sie dem Endpoint-Schema
PaginierungFeldnamen und Cursor-Stile unterscheiden sich je nach Endpoint
FehlerJSON mit status, code, message und request_id; Anbieterdetails können in der Meldung erscheinen
Rate-LimitsEndpoint- und anbieterspezifisch; rechnen Sie unter Last mit 429
AbrechnungPro Aufruf, aus demselben Service-Guthaben wie bei der Model API

Fehlerbehandlung

Ein Authentifizierungsfehler gibt dasselbe Format wie der Rest der Plattform zurück:

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

Bei einem Fehler auf Anbieterebene lesen Sie den HTTP-Status und die Meldung. Protokollieren Sie Methode, vollständigen Pfad, Form des Anfrage-Textkörpers und request_id. Protokollieren Sie niemals den vollständigen API-Schlüssel.

Wiederholungen

Wiederholen Sie 429- und 5xx-Antworten mit Backoff. Wiederholen Sie 400- oder 401-Antworten nicht unverändert. Einige Anbieteroperationen sind nicht gefahrlos wiederholbar; prüfen Sie den Endpoint, bevor Sie einen Schreibvorgang wiederholen.

Wann Sie stattdessen eine Felo API verwenden sollten

Verwenden Sie die Data API, wenn Sie eine bestimmte Drittanbieter-Datenquelle benötigen. Verwenden Sie eine Felo API, wenn Sie den eigenen Workflow von Felo möchten:

Verwandte Themen