Felo API PlatformFelo API Platform

Guías

Descripción general de Data API

Llama a endpoints de terceros mediante un prefijo compartido, con autenticación y gestión de solicitudes coherentes.

La Data API es un catálogo de API de terceros detrás de una sola clave de Felo. Es independiente de las API /v2 propias de Felo y de la Model API.

Prefijo compartido

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

La referencia muestra cada endpoint como una ruta completa que empieza por /v1/beta. Usa esa ruta tal cual sobre el host; no añadas de nuevo el prefijo compartido. Por ejemplo, el endpoint de búsqueda de Tavily es:

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

Encontrar un endpoint

  • Explora el directorio de API por proveedor.
  • Abre la referencia de la Data API para ver la lista completa de endpoints, los parámetros y los esquemas de respuesta.
  • Usa las etiquetas de la referencia para moverte entre proveedores.

Cada proveedor mantiene su propia forma de solicitud. La capa compartida estandariza la autenticación y el enrutamiento, no la carga útil. Lee el esquema del endpoint antes de enviar una solicitud.

Autenticación

Usa cualquiera de estos encabezados:

Authorization: Bearer $FELO_API_KEY

o:

X-API-Key: $FELO_API_KEY

Envía Content-Type: application/json para los cuerpos JSON.

Solicitud de ejemplo

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 forma de la respuesta procede del proveedor. Los campos como los resultados, los cursores de paginación y los metadatos no se normalizan entre proveedores.

Convenciones

TemaQué esperar
Carga útilJSON específico del proveedor; sigue el esquema del endpoint
PaginaciónLos nombres de campo y los estilos de cursor varían según el endpoint
ErroresJSON con status, code, message y request_id; los detalles del proveedor pueden aparecer en el mensaje
Límites de solicitudesEspecíficos del endpoint y del proveedor; espera 429 bajo carga
FacturaciónPor llamada, desde el mismo saldo de créditos de servicio que la Model API

Gestión de errores

Un fallo de autenticación devuelve el mismo sobre que el resto de la plataforma:

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

En un fallo a nivel de proveedor, lee el estado HTTP y el mensaje. Registra el método, la ruta completa, la forma del cuerpo de la solicitud y request_id. No registres la clave de API completa.

Reintentos

Reintenta las respuestas 429 y 5xx con retroceso exponencial. No reintentes sin cambios las respuestas 400 o 401. Algunas operaciones de proveedores no son seguras de repetir; comprueba el endpoint antes de reintentar una escritura.

Cuándo usar una API de Felo en su lugar

Usa la Data API cuando necesites una fuente de datos de terceros concreta. Usa una API de Felo cuando quieras el flujo de trabajo propio de Felo:

Relacionado