Felo API PlatformFelo API Platform

Guide

Panoramica di Data API

Chiama endpoint di terze parti tramite un prefisso condiviso, con autenticazione e gestione delle richieste coerenti.

La Data API è un catalogo di API di terze parti accessibili con un'unica chiave Felo. È separata dalle API /v2 di Felo e dalla Model API.

Prefisso condiviso

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

Il riferimento mostra ogni endpoint come percorso completo che inizia con /v1/beta. Usa quel percorso così com'è sull'host; non anteporre di nuovo il prefisso condiviso. Per esempio, l'endpoint di ricerca Tavily è:

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

Trovare un endpoint

  • Sfoglia la directory delle API per fornitore.
  • Apri il riferimento Data API per l'elenco completo degli endpoint, i parametri e gli schemi delle risposte.
  • Usa i tag del riferimento per spostarti tra i fornitori.

Ogni fornitore mantiene la propria struttura delle richieste. Lo strato condiviso standardizza autenticazione e routing, non il payload. Leggi lo schema dell'endpoint prima di inviare una richiesta.

Autenticazione

Usa uno dei due header:

Authorization: Bearer $FELO_API_KEY

oppure:

X-API-Key: $FELO_API_KEY

Invia Content-Type: application/json per i corpi JSON.

Richiesta di esempio

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 struttura della risposta dipende dal fornitore. Campi come risultati, cursori di paginazione e metadati non sono normalizzati tra i provider.

Convenzioni

ArgomentoCosa aspettarsi
PayloadJSON specifico del fornitore; segui lo schema dell'endpoint
PaginazioneI nomi dei campi e gli stili di cursore variano da endpoint a endpoint
ErroriJSON con status, code, message e request_id; i dettagli del provider possono comparire nel messaggio
Rate limitSpecifici dell'endpoint e del fornitore; prevedi 429 in caso di carico
FatturazionePer chiamata, dallo stesso saldo di crediti di servizio della Model API

Gestione degli errori

Un errore di autenticazione restituisce la stessa struttura del resto della piattaforma:

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

Per un errore a livello di provider, leggi lo stato HTTP e il messaggio. Registra il metodo, il percorso completo, la struttura del corpo della richiesta e il request_id. Non registrare mai la chiave API completa.

Retry

Riprova le risposte 429 e 5xx con backoff. Non riprovare 400 o 401 senza modifiche. Alcune operazioni dei provider non sono sicure da ripetere; controlla l'endpoint prima di riprovare una scrittura.

Quando usare invece una Felo API

Usa la Data API quando ti serve una specifica fonte di dati di terze parti. Usa una Felo API quando vuoi il workflow di Felo:

Correlati