Felo API PlatformFelo API Platform

Průvodci

Přehled Data API

Volejte endpointy třetích stran pod společnou předponou se stejným ověřováním a zpracováním požadavků.

Data API je katalog API třetích stran za jedním klíčem Felo. Je oddělené od vlastních API /v2 společnosti Felo a od Model API.

Sdílený prefix

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

Reference zobrazuje každý endpoint jako úplnou cestu začínající /v1/beta. Použijte tuto cestu tak, jak je, na hostiteli; nepřipojujte sdílený prefix znovu. Například endpoint vyhledávání Tavily je:

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

Najděte endpoint

  • Procházejte adresář API podle poskytovatele.
  • Otevřete referenci Data API pro úplný seznam endpointů, parametry a schémata odpovědí.
  • Pomocí značek v referenci se pohybujte mezi poskytovateli.

Každý poskytovatel si zachovává vlastní tvar požadavku. Sdílená vrstva standardizuje ověřování a směrování, nikoli tělo požadavku. Před odesláním požadavku si přečtěte schéma endpointu.

Ověřování

Použijte jednu z hlaviček:

Authorization: Bearer $FELO_API_KEY

nebo:

X-API-Key: $FELO_API_KEY

U těl JSON odešlete Content-Type: application/json.

Příklad požadavku

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

Tvar odpovědi pochází od poskytovatele. Pole jako výsledky, kurzory stránkování a metadata nejsou napříč poskytovateli normalizována.

Konvence

TémaCo očekávat
Tělo požadavkuJSON specifický pro poskytovatele; postupujte podle schématu endpointu
StránkováníNázvy polí a styly kurzorů se liší podle endpointu
ChybyJSON s status, code, message a request_id; podrobnosti poskytovatele se mohou objevit ve zprávě
Limity rychlostiSpecifické pro endpoint a poskytovatele; při zátěži očekávejte 429
FakturaceZa volání, ze stejného zůstatku kreditů služeb jako Model API

Řešení chyb

Selhání ověření vrací stejnou obálku jako zbytek platformy:

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

U selhání na úrovni poskytovatele přečtěte stav HTTP a zprávu. Zaznamenejte metodu, úplnou cestu, tvar těla požadavku a request_id. Nezaznamenávejte celý API klíč.

Opakování

Opakujte odpovědi 429 a 5xx s rostoucím odstupem. Neopakujte nezměněné požadavky 400 nebo 401. Některé operace poskytovatele není bezpečné opakovat; před opakováním zápisu zkontrolujte endpoint.

Kdy použít místo toho Felo API

Data API použijte, když potřebujete konkrétní zdroj dat třetí strany. Felo API použijte, když chcete vlastní workflow Felo:

Související