Mulai cepat API

Panduan ini membawa Anda dari nol ke permintaan pertama yang berhasil: membuat token pribadi, mengetahui alamat dasar, dan memanggil endpoint REST.

Langkah 1. Buat token pribadi

Buka panel pribadi, bagian token pribadi, dan buat token baru (PAT). Salin nilainya sekarang — nilai tersebut ditampilkan hanya sekali dan diawali dengan prefiks mbp_. Saat pembuatan, pilih cakupan akses (scopes) yang sesuai dengan kebutuhan Anda; detail lebih lanjut ada di panduan otorisasi.

Langkah 2. Alamat dasar dan format

Semua endpoint REST berada di bawah prefiks /api. Tidak ada versi di path. Body permintaan dan respons adalah JSON; kirimkan header Content-Type: application/json untuk permintaan dengan body. Token dikirimkan melalui header Authorization: Bearer mbp_….

Langkah 3. Permintaan pertama — daftar bot

Verifikasi token dengan meminta daftar bot Anda. Untuk ini diperlukan scope bots:read (atau *):

curl -H "Authorization: Bearer mbp_TOKEN_ANDA" https://domain-anda/api/bots

Responsnya adalah array JSON berisi bot. Jika token salah atau kedaluwarsa — akan dikembalikan 401 dengan body {"error":"..."} (lihat error).

Langkah 4. Mutasi pertama — buat reaksi

Membuat reaksi memerlukan scope reactions:write. Ganti identifier bot dari langkah 3:

curl -X POST -H "Authorization: Bearer mbp_TOKEN_ANDA" -H "Content-Type: application/json" -d '{"name":"Halo","trigger":{"type":"command","value":"/start"}}' https://domain-anda/api/bots/BOT_ID/reactions

Respons yang berhasil akan mengembalikan reaksi yang dibuat beserta id-nya. Field body yang tepat dapat dilihat di referensi interaktif — referensi tersebut menghasilkan contoh siap pakai dalam curl, JavaScript, dan Python untuk setiap endpoint.

Langkah 5. Selanjutnya — ikuti referensi

Setelah token berfungsi, sisanya lebih mudah dipelajari di referensi interaktif: di sana terlihat daftar lengkap endpoint, scopes yang diperlukan, schema body, dan tombol "Try it".

Selanjutnya