Felo API PlatformFelo API Platform

Przewodniki

Przegląd Data API

Wywołuj endpointy firm trzecich pod wspólnym prefiksem, zachowując spójne uwierzytelnianie i przetwarzanie żądań.

Data API to katalog zewnętrznych interfejsów API dostępnych przez jeden klucz Felo. Jest oddzielony od własnych interfejsów API Felo /v2 oraz od Model API.

Wspólny prefiks

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

Dokumentacja pokazuje każdy endpoint jako pełną ścieżkę zaczynającą się od /v1/beta. Użyj tej ścieżki bez zmian na hoście; nie dodawaj wspólnego prefiksu ponownie. Na przykład endpoint wyszukiwania Tavily to:

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

Znajdowanie endpointu

  • Przeglądaj katalog API według dostawcy.
  • Otwórz dokumentację Data API, aby zobaczyć pełną listę endpointów, parametry i schematy odpowiedzi.
  • Używaj tagów w dokumentacji, aby przechodzić między dostawcami.

Każdy dostawca zachowuje własny kształt żądania. Wspólna warstwa standaryzuje uwierzytelnianie i routing, a nie ładunek. Przed wysłaniem żądania przeczytaj schemat endpointu.

Uwierzytelnianie

Użyj jednego z nagłówków:

Authorization: Bearer $FELO_API_KEY

lub:

X-API-Key: $FELO_API_KEY

Dla treści JSON wysyłaj Content-Type: application/json.

Przykładowe żądanie

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

Kształt odpowiedzi pochodzi od dostawcy. Pola takie jak wyniki, kursory paginacji i metadane nie są normalizowane między dostawcami.

Konwencje

TematCzego się spodziewać
ŁadunekJSON specyficzny dla dostawcy; postępuj według schematu endpointu
PaginacjaNazwy pól i style kursorów różnią się w zależności od endpointu
BłędyJSON z polami status, code, message i request_id; szczegóły dostawcy mogą pojawić się w komunikacie
Limity szybkościZależą od endpointu i dostawcy; przy dużym obciążeniu spodziewaj się 429
RozliczeniaZa wywołanie, z tego samego salda kredytów usługowych co Model API

Obsługa błędów

Niepowodzenie uwierzytelniania zwraca tę samą kopertę co reszta platformy:

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

W przypadku niepowodzenia na poziomie dostawcy odczytaj status HTTP i komunikat. Zapisuj w logach metodę, pełną ścieżkę, kształt treści żądania i request_id. Nie zapisuj w logach pełnego klucza API.

Ponawianie

Ponawiaj odpowiedzi 429 i 5xx z wykładniczym opóźnieniem. Nie ponawiaj bez zmian odpowiedzi 400 ani 401. Niektóre operacje dostawców nie są bezpieczne do powtórzenia; przed ponowieniem operacji zapisu sprawdź endpoint.

Kiedy zamiast tego użyć Felo API

Użyj Data API, gdy potrzebujesz konkretnego zewnętrznego źródła danych. Użyj Felo API, gdy chcesz skorzystać z własnego przepływu pracy Felo:

Powiązane