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 menyertakan penyedia Felo dan pihak ketiga dalam direktori yang sama, di bawah kategori yang sudah ada. Panggilan menggunakan saldo platform; Felo APIs /v2 yang sudah ada menggunakan kredit Pro. Awalan bersama di bawah berlaku untuk penyedia pihak ketiga; lihat pengaturan Felo untuk jalur dan contoh Felo.

Awalan bersama

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

Referensi menampilkan setiap endpoint sebagai jalur lengkap yang dimulai dengan /v1/beta. Gunakan jalur itu apa adanya pada host; jangan tambahkan awalan bersama lagi. Misalnya, endpoint pencarian Tavily adalah:

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

Temukan endpoint

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

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 body 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. Bidang seperti hasil, cursor paginasi, dan metadata tidak dinormalisasi lintas penyedia.

Konvensi

TopikYang diharapkan
PayloadJSON khusus penyedia; ikuti skema endpoint
PaginasiNama bidang dan gaya cursor bervariasi menurut endpoint
KesalahanJSON dengan status, code, message, dan request_id; detail penyedia dapat muncul di pesan
Batas lajuKhusus endpoint dan penyedia; harapkan 429 saat beban tinggi
PenagihanPer panggilan, dari saldo kredit layanan yang sama dengan Model API

Penanganan kesalahan

Kegagalan autentikasi mengembalikan pembungkus yang sama seperti sisa platform:

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

Untuk kegagalan di tingkat penyedia, baca status HTTP dan pesan. Catat method, path lengkap, bentuk body permintaan, dan request_id. Jangan catat API key penuh.

Retry

Retry respons 429 dan 5xx dengan backoff. Jangan retry 400 atau 401 tanpa perubahan. Beberapa operasi penyedia tidak aman untuk diulang; periksa endpoint sebelum retry tulis.

Kapan menggunakan Felo API sebagai gantinya

Gunakan Data API ketika Anda membutuhkan sumber data pihak ketiga yang spesifik. Gunakan Felo API ketika Anda menginginkan alur kerja milik Felo:

Terkait

Butuh bantuan?