Felo API PlatformFelo API Platform

Guias

Visão geral da Data API

Chame endpoints de terceiros por um prefixo compartilhado, com autenticação e tratamento de requisições consistentes.

A Data API é um catálogo de APIs de terceiros atrás de uma única chave Felo. Ela é separada das APIs /v2 da própria Felo e da Model API.

Prefixo compartilhado

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

A referência mostra cada endpoint como um caminho completo que começa com /v1/beta. Use esse caminho como está no host; não acrescente o prefixo compartilhado de novo. Por exemplo, o endpoint de busca da Tavily é:

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

Encontre um endpoint

  • Navegue pelo diretório de APIs por fornecedor.
  • Abra a referência da Data API para ver a lista completa de endpoints, os parâmetros e os esquemas de resposta.
  • Use as tags da referência para navegar entre fornecedores.

Cada fornecedor mantém seu próprio formato de requisição. A camada compartilhada padroniza autenticação e roteamento, não o payload. Leia o esquema do endpoint antes de enviar uma requisição.

Autenticação

Use um dos dois cabeçalhos:

Authorization: Bearer $FELO_API_KEY

ou:

X-API-Key: $FELO_API_KEY

Envie Content-Type: application/json para corpos JSON.

Exemplo de requisição

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

O formato da resposta vem do fornecedor. Campos como resultados, cursores de paginação e metadados não são normalizados entre provedores.

Convenções

TemaO que esperar
PayloadJSON específico do fornecedor; siga o esquema do endpoint
PaginaçãoNomes de campo e estilos de cursor variam por endpoint
ErrosJSON com status, code, message e request_id; detalhes do provedor podem aparecer na mensagem
Limites de requisiçõesEspecíficos do endpoint e do fornecedor; espere 429 sob carga
CobrançaPor chamada, a partir do mesmo saldo de créditos de serviço da Model API

Tratamento de erros

Uma falha de autenticação retorna o mesmo envelope do restante da plataforma:

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

Para uma falha no nível do provedor, leia o status HTTP e a mensagem. Registre o método, o caminho completo, o formato do corpo da requisição e o request_id. Não registre a chave de API completa.

Novas tentativas

Tente novamente respostas 429 e 5xx com backoff. Não repita 400 ou 401 sem alterações. Algumas operações de provedores não são seguras de repetir; verifique o endpoint antes de tentar novamente uma escrita.

Quando usar uma Felo API em vez disso

Use a Data API quando precisar de uma fonte de dados de terceiros específica. Use uma Felo API quando quiser o fluxo próprio da Felo:

Relacionados