Felo API PlatformFelo API Platform

Panduan

Ringkasan Data API

Panggil endpoint pihak ketiga melalui satu prefiks bersama, dengan autentikasi dan penanganan permintaan yang konsisten.

Data API adalah katalog API pihak ketiga di balik satu kunci Felo. Data API terpisah dari API /v2 milik Felo sendiri dan dari Model API.

Prefiks bersama

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

Referensi menampilkan setiap endpoint sebagai path lengkap yang dimulai dengan /v1/beta. Gunakan path tersebut apa adanya pada host; jangan menambahkan prefiks bersama lagi. Misalnya, endpoint pencarian Tavily adalah:

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

Menemukan endpoint

  • Jelajahi direktori API berdasarkan penyedia.
  • Buka referensi Data API untuk daftar endpoint lengkap, parameter, dan skema respons.
  • Gunakan tag pada referensi untuk berpindah antarpenyedia.

Setiap penyedia mempertahankan bentuk permintaannya sendiri. Lapisan bersama menstandarkan autentikasi dan routing, bukan payload. Baca skema endpoint sebelum mengirim permintaan.

Autentikasi

Gunakan salah satu header:

Authorization: Bearer $FELO_API_KEY

atau:

X-API-Key: $FELO_API_KEY

Kirim Content-Type: application/json untuk isi permintaan JSON.

Contoh permintaan

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

Bentuk respons berasal dari penyedia. Field seperti hasil, kursor paginasi, dan metadata tidak dinormalisasi antarpenyedia.

Konvensi

TopikYang diharapkan
PayloadJSON spesifik penyedia; ikuti skema endpoint
PaginasiNama field dan gaya kursor berbeda-beda per endpoint
ErrorJSON dengan status, code, message, dan request_id; detail penyedia dapat muncul di dalam message
Batas lajuSpesifik endpoint dan penyedia; perkirakan 429 saat beban tinggi
PenagihanPer panggilan, dari saldo kredit layanan yang sama dengan Model API

Penanganan Error

Kegagalan autentikasi mengembalikan envelope yang sama dengan bagian lain platform:

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

Untuk kegagalan di tingkat penyedia, baca status HTTP dan message. Catat metode, path lengkap, bentuk isi permintaan, dan request_id. Jangan mencatat kunci API lengkap.

Percobaan Ulang

Coba ulang respons 429 dan 5xx dengan backoff. Jangan mencoba ulang 400 atau 401 tanpa perubahan. Sebagian operasi penyedia tidak aman untuk diulang; periksa endpoint sebelum mencoba ulang operasi tulis.

Kapan menggunakan Felo APIs sebagai gantinya

Gunakan Data API saat Anda memerlukan sumber data pihak ketiga tertentu. Gunakan Felo APIs saat Anda menginginkan alur kerja milik Felo sendiri:

Terkait