Referensi HumanDesign.ai Agent HTTP API
Ringkasan
Agent HTTP menyediakan enam operasi kalkulasi dan referensi yang sama sebagai endpoint HTTP. Gunakan jika aplikasi Anda membutuhkan pemanggilan HTTP bernama alih-alih protokol MCP.
Jalur dasar: https://api.humandesign.ai/agent/v1/tools
Autentikasi
Setiap permintaan menggunakan salah satu Authorization: Bearer YOUR_HDAI_API_KEY atau X-Api-Key: YOUR_HDAI_API_KEY. Kredensial dalam query string tidak didukung.
Endpoint
- POST. Jalur:
/resolve-timezone. Tujuan: Memetakan lokasi ke zona waktu dan metadata geografis. - POST. Jalur:
/generate-chart. Tujuan: Membuat bagan natal. - POST. Jalur:
/generate-composite-chart. Tujuan: Membuat bagan komposit dua orang. - POST. Jalur:
/get-reference-item. Tujuan: Membaca entri gerbang, kanal, pusat, atau profil. - POST. Jalur:
/get-transits. Tujuan: Mendapatkan prakiraan atau respons natal-versus-transit. - POST. Jalur:
/search-celebrities. Tujuan: Mencari katalog tokoh publik.
Format respons
Respons berhasil menggunakan envelope berversi:
{
"version": "v1",
"tool": "generate_chart",
"data": {},
"meta": {},
"error": null
}
API tersebut meta Objek tersebut mencakup informasi permintaan dan kuota. Perlakukan bidang respons sebagai data terstruktur; jangan jadikan teks ringkasan sebagai sumber kebenaran.
Akses dan kuota
API memeriksa hak penggunaan sebelum menjalankan operasi. Setiap permintaan yang berhasil menggunakan satu unit API bersama. Operasi dan batas penggunaan yang tersedia bergantung pada tingkat API Anda saat ini; ambil informasi ketersediaan terbaru melalui katalog MCP terautentikasi atau alat akun Anda, jangan mengandalkan tabel harga yang disalin.