Felo API PlatformFelo API Platform

Посібники

Огляд Data API

Викликайте endpoint третіх сторін під спільним префіксом із тими самими автентифікацією та обробкою запитів.

Data API — це каталог сторонніх API за одним ключем Felo. Він відокремлений від власних API Felo /v2 і від Model API.

Спільний префікс

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

Довідник показує кожен endpoint як повний шлях, що починається з /v1/beta. Використовуйте цей шлях як є на хості; не додавайте спільний префікс повторно. Наприклад, endpoint пошуку Tavily такий:

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

Як знайти endpoint

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

Кожен постачальник зберігає власну структуру запиту. Спільний рівень стандартизує автентифікацію та маршрутизацію, а не корисне навантаження. Прочитайте схему 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
  }'

Структура відповіді походить від постачальника. Такі поля, як результати, курсори пагінації та метадані, не нормалізуються між постачальниками.

Умовності

ТемаЧого очікувати
Корисне навантаженняJSON, специфічний для постачальника; дотримуйтеся схеми endpoint
ПагінаціяНазви полів і стилі курсорів різняться залежно від endpoint
ПомилкиJSON із status, code, message і request_id; відомості постачальника можуть з'являтися в повідомленні
Обмеження швидкостіЗалежать від endpoint і постачальника; очікуйте 429 під навантаженням
ОплатаЗа виклик, із того самого балансу кредитів послуг, що й Model API

Обробка помилок

Помилка автентифікації повертає ту саму структуру, що й решта платформи:

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

У разі збою на рівні постачальника прочитайте код стану HTTP і повідомлення. Записуйте в журнал метод, повний шлях, структуру тіла запиту та request_id. Не записуйте в журнал повний API-ключ.

Повторні спроби

Повторюйте запити з відповідями 429 і 5xx із збільшенням інтервалу. Не повторюйте 400 або 401 без змін. Деякі операції постачальника небезпечно повторювати; перевірте endpoint, перш ніж повторювати операцію запису.

Коли натомість використовувати Felo API

Використовуйте Data API, коли вам потрібне конкретне стороннє джерело даних. Використовуйте Felo API, коли потрібен власний робочий процес Felo:

Пов'язані розділи