Felo API PlatformFelo API Platform

Panduan

Gambaran keseluruhan Data API

Panggil endpoint pihak ketiga melalui satu awalan kongsi, dengan pengesahan dan pengendalian permintaan yang konsisten.

Data API ialah katalog API pihak ketiga di belakang satu kunci Felo. Ia berasingan daripada API /v2 Felo sendiri dan daripada Model API.

Awalan dikongsi

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

Rujukan menunjukkan setiap endpoint sebagai laluan penuh yang bermula dengan /v1/beta. Gunakan laluan itu sebagaimana adanya pada hos; jangan tambah awalan dikongsi sekali lagi. Sebagai contoh, endpoint carian Tavily ialah:

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

Cari endpoint

  • Layari direktori API mengikut pembekal.
  • Buka rujukan Data API untuk senarai endpoint penuh, parameter, dan skema respons.
  • Gunakan tag rujukan untuk bergerak antara pembekal.

Setiap pembekal mengekalkan bentuk permintaannya sendiri. Lapisan dikongsi menyeragamkan pengesahan dan penghalaan, bukan muatan. Baca skema endpoint sebelum menghantar permintaan.

Pengesahan

Gunakan sama ada pengepala:

Authorization: Bearer $FELO_API_KEY

atau:

X-API-Key: $FELO_API_KEY

Hantar Content-Type: application/json untuk badan 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 datang daripada pembekal. Medan seperti hasil, kursor penomboran, dan metadata tidak dinormalkan merentas penyedia.

Konvensyen

TopikApa yang dijangkakan
MuatanJSON khusus pembekal; ikuti skema endpoint
Penomboran halamanNama medan dan gaya kursor berbeza mengikut endpoint
RalatJSON dengan status, code, message, dan request_id; butiran penyedia mungkin muncul dalam mesej
Had kadarKhusus endpoint dan pembekal; jangkakan 429 di bawah beban
PengebilanSetiap panggilan, daripada baki kredit perkhidmatan yang sama seperti Model API

Pengendalian ralat

Kegagalan pengesahan mengembalikan sampul yang sama seperti seluruh platform:

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

Untuk kegagalan peringkat penyedia, baca status HTTP dan mesej. Log kaedah, laluan penuh, bentuk isi badan permintaan, dan request_id. Jangan log kunci API penuh.

Cubaan semula

Cuba semula respons 429 dan 5xx dengan backoff. Jangan cuba semula 400 atau 401 tanpa perubahan. Sesetengah operasi penyedia tidak selamat diulang; semak endpoint sebelum mencuba semula operasi tulis.

Bila hendak menggunakan Felo API sebaliknya

Gunakan Data API apabila anda memerlukan sumber data pihak ketiga tertentu. Gunakan Felo API apabila anda mahu aliran kerja Felo sendiri:

Berkaitan