Bot oluşturma¶

Bir uygulama oluşturmak, bot kullanıcısını ve ilk bot token'ını tek adımda oluşturur. Bunu TEBHOS uygulamasında veya HTTP API üzerinden yapabilirsiniz. Her iki durumda da normal, sahiplenilmiş bir TEBHOS hesabı gerekir; sahiplenilmemiş (misafir) hesaplar uygulama oluşturamaz.

TEBHOS uygulamasında¶

1. Kullanıcı Ayarları'nı açın (adınızın yanındaki dişli simgesi).
2. Kenar çubuğunun Geliştirici bölümünde Uygulamalar'ı seçin.
3. Uygulama oluştur'u seçin, bir uygulama adı girin ve onaylayın.
4. Uygulama sayfası açılır. Gizli anahtarlar ve token'lar altında Bot token'ını kopyalayın ve güvenli bir yerde saklayın.

Aynı sayfada botun profilini (ad, avatar, afiş, biyografi) düzenleyebilir, bot token'ını ve istemci gizli anahtarını yeniden oluşturabilir ve OAuth2 URL oluşturucu altında bir yetkilendirme bağlantısı hazırlayabilirsiniz (bkz. Botu bir sunucuya ekleme).

HTTP API ile¶

Uygulama yönetimiyle ilgili tüm uç noktalar bir kullanıcı oturumu (Authorization: Bearer ...) gerektirir. Bir bot token'ı uygulamaları yönetemez. Yollar https://tebhos.com/api/v1 adresine görelidir.

Uygulama oluştur¶

POST /oauth2/applications

Bir uygulama, bot kullanıcısı ve ilk bot token'ını oluşturur. Hız sınırı: kullanıcı başına saatte 10. Her kullanıcı en fazla 25 uygulamaya sahip olabilir; 26. uygulamayı oluşturmak MAX_APPLICATIONS koduyla 400 döndürür.

Örnekte (instance) CAPTCHA etkinse bu istek ayrıca x-captcha-token ve x-captcha-type CAPTCHA başlıklarını taşımalıdır, bkz. Captcha. Uygulamayı TEBHOS uygulamasında oluşturduğunuzda bu sizin için halledilir.

curl -X POST https://tebhos.com/api/v1/oauth2/applications \
  -H "Authorization: Bearer $TEBHOS_USER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Night Watch"}'

{
  "id": "1290847135893127168",
  "name": "Night Watch",
  "redirect_uris": [],
  "bot_public": true,
  "bot_require_code_grant": false,
  "bot": {
    "id": "1290847135893127168",
    "username": "Night_Watch",
    "discriminator": "0001",
    "avatar": null,
    "banner": null,
    "bio": null,
    "mfa_enabled": false,
    "authenticator_types": [],
    "flags": 0,
    "token": "1290847135893127168.q3JxY2V0...W5k"
  },
  "client_secret": "Zk9hc2Rm...Tmdh"
}

Bot kullanıcısının kimliği uygulama kimliğidir. Kullanıcı adı uygulama adından türetilir: harfler, rakamlar ve alt çizgiler korunur; boşluklar, kısa çizgiler ve noktalar alt çizgiye dönüşür; diğer karakterler atılır ve sonuç 32 karaktere kısaltılır. Geriye 2 karakterden az kalırsa rastgele bir ad seçilir. Ayırt edici (discriminator), o kullanıcı adı için hâlâ boş olan ilk değerdir. Botu daha sonra yeniden adlandırabilirsiniz.

bot.token ve client_secret yalnızca bu yanıtta görünür. Uygulama nesnesinin tamamı için bkz. Uygulamalar.

Uygulamalarınızı listeleyin¶

GET /oauth2/applications/@me

Sahip olduğunuz uygulamaları gizli anahtarlar olmadan bir dizi olarak döndürür. Hız sınırı: dakikada 60. GET /users/@me/applications aynı listeyi döndürür.

Uygulamayı al¶

GET /oauth2/applications/{application_id}

Uygulamalarınızdan birini döndürür. Sahibi değilseniz 403 döndürür.

Uygulamayı güncelle¶

PATCH /oauth2/applications/{application_id}

name, redirect_uris (listenin tamamını değiştirir), bot_public veya bot_require_code_grant alanlarını günceller. Her alan isteğe bağlıdır. Hız sınırı: uygulama başına dakikada 30.

Bot profilini güncelle¶

PATCH /oauth2/applications/{application_id}/bot

Bot kullanıcısının herkese açık profilini değiştirir. Hız sınırı: uygulama başına dakikada 30.

Yanıt botun profilidir: id, username, discriminator, avatar, banner, bio ve flags.

Bot token'ını yeniden oluştur¶

POST /oauth2/applications/{application_id}/bot/reset-token

Yeni bir bot token'ı verir ve eskisini hemen geçersiz kılar. Botun açık olan tüm gateway bağlantıları kapatılır; bu nedenle botunuz yeni token'la yeniden bağlanmalıdır. Hız sınırı: uygulama başına saatte 10.

Bu, sudo kipi gerektiren hassas bir işlemdir: JSON gövdesine password, bir mfa_code veya bir geçiş anahtarı (passkey) sudo_proof değeri ekleyin ya da isteği başka bir başarılı sudo doğrulamasından sonraki birkaç dakika içinde yapın. Bu olmadan istek, code değeri SUDO_REQUIRED olan bir 403 döndürür. Bkz. Kimlik doğrulama.

curl -X POST https://tebhos.com/api/v1/oauth2/applications/1290847135893127168/bot/reset-token \
  -H "Authorization: Bearer $TEBHOS_USER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"password": "your-account-password"}'

{
  "token": "1290847135893127168.Tm90QVJl...YWxUb2tlbg",
  "bot": { "id": "1290847135893127168", "username": "Night_Watch", "discriminator": "0001", "flags": 0 }
}

İstemci gizli anahtarını yeniden oluştur¶

POST /oauth2/applications/{application_id}/client-secret/reset

Yeni bir istemci gizli anahtarı verir; bu anahtar uygulama nesnesinde client_secret olarak yalnızca bir kez döndürülür. Sudo gereksinimi ve hız sınırı bot token'ıyla aynıdır.

Uygulamayı sil¶

DELETE /oauth2/applications/{application_id}

Uygulamayı siler. Botu tüm sunuculardan çıkarılır, profili anonimleştirilir ve gateway bağlantıları kapatılır; daha önce gönderdiği mesajlar yerinde kalır. Sudo kipi gerektirir. Hız sınırı: uygulama başına saatte 10. 204 döndürür.

Bot token'ını kontrol et¶

GET /applications/@me

Bot token'ıyla çağrıldığında botun kendi uygulamasını döndürür. Başka herhangi bir kimlik bilgisi 401 döndürür. Gateway'e bağlanmadan önce bir token'ın çalıştığını doğrulamak için kullanın.

curl https://tebhos.com/api/v1/applications/@me \
  -H "Authorization: Bot $TEBHOS_BOT_TOKEN"

Sıradaki adım: botu bir sunucuya ekleyin, ardından gateway'e bağlanın.