Otentikasi

API Annie Insights menggunakan autentikasi kunci API melalui header HTTP x-api-key.

Cara Kerjanya

Sertakan kunci API Anda di setiap permintaan sebagai header HTTP:

x-api-key: YOUR_API_KEY

Contoh

curl -X POST \
  https://api.annie-insights.com/api/v2/clinical-images \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"PatientID": "P-001", "TimeStamp": "2026-05-24", "ImageName": "https://..."}'

Mendapatkan Kunci API

Jenis	Bagaimana Mendapatkannya	Kasus Penggunaan
Kunci Kotak Pasir	Tersedia di halaman Sandbox.	Pengujian & pengembangan
Kunci Produksi	Hubungi api-support@hcds.ai	Integrasi produksi

Praktik Terbaik Keamanan

peringatan

Jangan pernah mengekspos kunci API Anda dalam kode sisi klien. Selalu lakukan panggilan API dari server backend Anda.

• Simpan kunci dengan aman — Gunakan variabel lingkungan atau pengelola rahasia
• Putar kunci secara berkala — Minta kunci baru jika Anda mencurigai adanya kompromi
• Gunakan HTTPS saja — Semua titik akhir API memerlukan enkripsi TLS
• Pantau penggunaan — Lacak jumlah permintaan Anda melalui header respons

Respons Kesalahan

Jika autentikasi gagal, API akan mengembalikan:

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key",
  "statusCode": 401
}

Lihat Error Handling untuk semua kode kesalahan.