Memulai dengan API
Buat token akses, lihat daftar bot, dan buat reaksi pertama dengan contoh perintah curl.
Di halaman ini
API memungkinkan program menjalankan tindakan di GetMyBot, misalnya melihat daftar bot, membuat reaksi, dan mengambil data. Panduan ini ditujukan bagi pengembang integrasi. Jika Anda ingin menyiapkan bot tanpa menulis kode, gunakan pembuat bot visual.
Pertama, buat kunci akses yang disebut token pribadi. Setelah itu, kirim permintaan HTTP ke alamat tindakan yang disebut endpoint. Contoh di bawah menggunakan curl di terminal. Ganti https://domain-anda dengan alamat instalasi GetMyBot Anda.
Langkah 1. Buat token pribadi
Buka bagian token pribadi di akun Anda, lalu buat token baru (PAT). Segera salin nilainya: token hanya ditampilkan sekali dan diawali mbp_. Pilih cakupan akses (scopes) sesuai tindakan yang diperlukan saja. Penjelasannya ada di panduan otorisasi.
Langkah 2. Periksa alamat dan format
Semua endpoint REST berawalan /api, tanpa nomor versi di alamatnya. Data dalam permintaan dan respons berformat JSON. Untuk permintaan yang mengirim data, sertakan Content-Type: application/json. Kirim token melalui header Authorization: Bearer <TOKEN_PRIBADI>. Ganti seluruh <TOKEN_PRIBADI>, termasuk tanda kurung sudutnya, dengan nilai token lengkap yang sudah memiliki awalan mbp_. Jangan tambahkan awalan itu lagi.
Langkah 3. Lihat daftar bot
Uji token dengan meminta daftar bot Anda. Tindakan ini memerlukan cakupan bots:read atau *:
curl -H "Authorization: Bearer <TOKEN_PRIBADI>" https://domain-anda/api/bots
Respons berisi daftar bot dalam format JSON. Jika token salah atau sudah kedaluwarsa, server mengirim 401 dan respons {"error":"..."}. Lihat panduan kesalahan.
Langkah 4. Buat reaksi
Permintaan ini mengubah data dengan membuat reaksi baru. Jalankan hanya pada bot yang memang memerlukan reaksi tersebut. Anda membutuhkan cakupan reactions:write. Ganti BOT_ID dengan ID bot dari langkah 3:
curl -X POST https://domain-anda/api/bots/BOT_ID/reactions \
-H "Authorization: Bearer <TOKEN_PRIBADI>" \
-H "Content-Type: application/json" \
-d '{"name":"Halo","trigger":{"type":"command","value":"/start"}}'
Jika berhasil, respons berisi reaksi yang dibuat beserta id-nya. Untuk rincian data yang dapat dikirim, buka referensi interaktif. Halaman itu menyediakan contoh curl, JavaScript, dan Python untuk setiap endpoint.
Langkah 5. Gunakan referensi API
Setelah token berhasil digunakan, lihat operasi lainnya di referensi interaktif. Di sana tercantum alamat API, cakupan akses yang dibutuhkan, format data, serta tombol Try it untuk mencobanya.
Permintaan pertama ke Managed AI
Buat PAT dengan cakupan managed_ai:invoke. Nilai Idempotency-Key membedakan satu tindakan dari tindakan lain. Saat mengulangi permintaan yang sama, gunakan kunci dan isi permintaan yang sama. Untuk tindakan baru, gunakan kunci baru.
curl -X POST https://domain-anda/api/v1/ai/responses \
-H "Authorization: Bearer <TOKEN_PRIBADI>" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: ai-demo-0001" \
-d '{"profile":"balanced","provider":"auto","input":[{"role":"user","content":[{"type":"input_text","text":"Ringkas percakapan ini"}]}],"max_output_tokens":300}'
Jika integrasi Anda menampilkan fungsi Managed AI atau Meta, periksa /api/public/capabilities terlebih dahulu. Responsnya menunjukkan fungsi mana yang aktif pada instalasi ini. Jika suatu fungsi nonaktif, sembunyikan atau tampilkan keterangan bahwa fungsi belum tersedia.
Langkah berikutnya
- Otorisasi dan token: PAT, header, dan cakupan akses.
- Kesalahan API: format respons dan kode status.
- Paginasi: cara membaca daftar yang panjang.