Felo API PlatformFelo API Platform

Руководства

Обзор Data API

Вызывайте сторонние endpoint'ы через общий префикс, сохраняя единообразную аутентификацию и обработку запросов.

Data API — это каталог сторонних API за одним key Felo. Он отделён от собственных API /v2 Felo и от Model API.

Общий префикс

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

Справочник показывает каждый endpoint как полный путь, начинающийся с /v1/beta. Используйте этот путь на host как есть; не добавляйте общий префикс повторно. Например, endpoint поиска Tavily:

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

Найти endpoint

  • Просмотрите каталог API по поставщикам.
  • Откройте справочник Data API, чтобы увидеть полный список endpoint'ов, параметры и схемы ответов.
  • Используйте теги справочника для перехода между поставщиками.

Каждый поставщик сохраняет свою форму запроса. Общий слой стандартизирует аутентификацию и маршрутизацию, но не payload. Прочитайте схему endpoint'а перед отправкой запроса.

Аутентификация

Используйте любой из заголовков:

Authorization: Bearer $FELO_API_KEY

или:

X-API-Key: $FELO_API_KEY

Для JSON-тел отправляйте Content-Type: application/json.

Пример запроса

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

Форму ответа определяет поставщик. Такие поля, как results, курсоры пагинации и metadata, не нормализуются между провайдерами.

Соглашения

ТемаЧего ожидать
PayloadJSON конкретного поставщика; следуйте схеме endpoint'а
PaginationИмена полей и стиль курсоров зависят от endpoint'а
ErrorsJSON с status, code, message и request_id; детали провайдера могут быть в message
Rate limitsЗависят от endpoint'а и поставщика; при нагрузке ожидайте 429
BillingЗа вызов, из того же баланса сервисных кредитов, что и Model API

Обработка ошибок

Сбой аутентификации возвращает ту же оболочку, что и остальная платформа:

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

При ошибке уровня провайдера читайте HTTP-статус и message. Записывайте method, полный путь, форму тела запроса и request_id. Не логируйте полный API key.

Повторные попытки

Повторяйте ответы 429 и 5xx с backoff. Не повторяйте 400 или 401 без изменений. Некоторые операции провайдера не безопасно повторять; проверьте endpoint перед повтором записи.

Когда лучше использовать Felo API

Используйте Data API, когда нужен конкретный сторонний источник данных. Используйте Felo API, когда нужен собственный рабочий процесс Felo:

Связанные разделы