# 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](https://openapi.felo.ai/id/docs/api-reference/openapi/overview.md) untuk jalur dan contoh Felo.
## Awalan bersama

```text
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:

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

## Temukan endpoint

- Telusuri [direktori API](https://openapi.felo.ai/id/apis) berdasarkan penyedia.
- Buka [referensi Data API](https://openapi.felo.ai/id/docs/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:

```http
Authorization: Bearer $FELO_API_KEY
```

atau:

```http
X-API-Key: $FELO_API_KEY
```

Kirim `Content-Type: application/json` untuk body JSON.

## Contoh permintaan

```bash
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

| Topik | Yang diharapkan |
|-------|----------------|
| Payload | JSON khusus penyedia; ikuti skema endpoint |
| Paginasi | Nama bidang dan gaya cursor bervariasi menurut endpoint |
| Kesalahan | JSON dengan `status`, `code`, `message`, dan `request_id`; detail penyedia dapat muncul di pesan |
| Batas laju | Khusus endpoint dan penyedia; harapkan 429 saat beban tinggi |
| Penagihan | Per panggilan, dari saldo kredit layanan yang sama dengan Model API |

## Penanganan kesalahan

Kegagalan autentikasi mengembalikan pembungkus yang sama seperti sisa platform:

```json
{
  "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:

- Jawaban berbasis pencarian dengan sitasi: [Chat API](https://openapi.felo.ai/id/docs/api-reference/chat.md)
- Pembuatan slide: [PPT Task API](https://openapi.felo.ai/id/docs/api-reference/ppt-tasks.md)
- Landing page: [Landing Page Task API](https://openapi.felo.ai/id/docs/api-reference/landing-page.md)
- Basis pengetahuan dan pengambilan: [LiveDoc API](https://openapi.felo.ai/id/docs/api-reference/livedocs.md)
- Percakapan agen dengan streaming: [SuperAgent API](https://openapi.felo.ai/id/docs/api-reference/superagent.md)

## Terkait

- [Direktori API](https://openapi.felo.ai/id/apis)
- [Referensi Data API](https://openapi.felo.ai/id/docs/data-api)
- [Autentikasi](https://openapi.felo.ai/id/docs/authentication.md)
- [Kesalahan, Batas, dan Retry](https://openapi.felo.ai/id/docs/guides/errors-and-limits.md)
