API Hızlı Başlangıç

Bu kılavuz sizi sıfırdan ilk başarılı isteğe götürür: kişisel token oluşturun, temel adresi öğrenin ve bir REST uç noktasını çağırın.

Adım 1. Kişisel Token Oluşturma

Kişisel hesap panelini, kişisel tokenler bölümünü açın ve yeni bir token (PAT) oluşturun. Değerini hemen kopyalayın — yalnızca bir kez gösterilir ve mbp_ önekiyle başlar. Oluşturma sırasında göreviniz için yeterli erişim kapsamlarını (scopes) seçin; ayrıntılar için yetkilendirme kılavuzuna bakın.

Adım 2. Temel Adres ve Biçim

Tüm REST uç noktaları /api öneki altındadır. Yolda sürüm numarası yoktur. İstek ve yanıt gövdeleri JSON biçimindedir; gövdeli istekler için Content-Type: application/json başlığını gönderin. Token Authorization: Bearer mbp_… başlığıyla iletilir.

Adım 3. İlk İstek — Bot Listesi

Botlarınızın listesini isteyerek tokeni doğrulayın. Bunun için bots:read (veya *) kapsamı gereklidir:

curl -H "Authorization: Bearer mbp_TOKENINIZ" https://alan-adiniz/api/bots

Yanıt olarak bir bot JSON dizisi gelir. Token hatalı veya süresi dolmuşsa {"error":"..."} gövdesiyle 401 döner (bkz. hatalar).

Adım 4. İlk Mutasyon — Tepki Oluşturma

Tepki oluşturmak için reactions:write kapsamı gerekir. 3. adımdaki bot tanımlayıcısını kullanın:

curl -X POST -H "Authorization: Bearer mbp_TOKENINIZ" -H "Content-Type: application/json" -d '{"name":"Merhaba","trigger":{"type":"command","value":"/start"}}' https://alan-adiniz/api/bots/BOT_ID/reactions

Başarılı yanıt, oluşturulan tepkiyi ve id'sini döndürür. Gövde alanlarının tam listesi için etkileşimli referansa bakın — her uç nokta için curl, JavaScript ve Python örnekleri hazır olarak sunulur.

Adım 5. Devamı — Referansla

Token çalışmaya başladıktan sonra geri kalanı etkileşimli referanstan incelemek daha kolaydır: uç noktaların tam listesi, gerekli kapsamlar, gövde şemaları ve "Dene" düğmesi orada bulunur.

Sonraki Adımlar