Geçerli kullanıcı¶

Geçerli kullanıcı, kimlik bilgisini sunan hesaptır ve bir kullanıcı nesnesiyle temsil edilir. Buradaki yollar bu hesabı okur, değiştirir ve yaşam döngüsü işlemlerini yürütür.

Bu sayfadaki Geçerli kullanıcıyı getir dışındaki her yol bir kullanıcı oturumu (Authorization: Bearer <token>) gerektirir. Geçerli bir bot token'ı veya geçerli bir OAuth2 erişim token'ı 403 ACCESS_DENIED ile reddedilir.

Sudo doğrulaması¶

Güvenlik açısından hassas değişiklikler (kullanıcı adı, yaşam döngüsü işlemleri, yetkili IP'leri unutma ve birkaç MFA yolu) istek gövdesinde kimlik kanıtı gerektirir. Her yerde aynı üç isteğe bağlı alan kabul edilir:

sudo_proof, mfa_code, password sırasındaki ilk boş olmayan alan denetlenir.

Kabul edilen bir kanıt içermeyen istek 403 ile başarısız olur:

{
  "error": "SUDO_REQUIRED",
  "code": "SUDO_MODE_REQUIRED",
  "message": "..."
}

Yanlış bir parola veya kod 401 UNAUTHORIZED ile başarısız olur. Parola denemeleri hesap başına 5 dakikada 10 ile (kova auth:sudo_pwd), kod denemeleri ise 15 dakikada 10 ile (kova auth:sudo_mfa) sınırlıdır.

Geçerli kullanıcıyı getir¶

GET /users/@me

Geçerli kullanıcı nesnesini döndürür. Bu sayfada bot token'ını (Authorization: Bot <token>) da kabul eden tek yol budur; bir bot bot: true ile kendi kullanıcı nesnesini alır.

identify kapsamlı bir OAuth2 erişim token'ını da kabul eder.

Erişim token'ı yanıtı¶

OAuth2 erişim token'ıyla yanıt aynı kullanıcı nesnesidir; özel alanlar nötr değerlerle değiştirilir:

Diğer tüm alanlar bir oturumda olduğu gibi döner.

Yanıt¶

Hız sınırı¶

Kullanıcı başına 10 saniyede 40 istek, kova user:settings:get; Geçerli kullanıcı ayarlarını getir ile paylaşılır.

curl https://tebhos.com/api/v1/users/@me \
  -H "Authorization: Bearer $TEBHOS_TOKEN"

const res = await fetch("https://tebhos.com/api/v1/users/@me", {
  headers: { Authorization: `Bot ${process.env.TEBHOS_BOT_TOKEN}` },
});
const me = await res.json();
console.log(me.username, me.id);

import os, requests

r = requests.get(
    "https://tebhos.com/api/v1/users/@me",
    headers={"Authorization": f"Bot {os.environ['TEBHOS_BOT_TOKEN']}"},
)
print(r.json()["username"])

Geçerli kullanıcıyı değiştir¶

PATCH /users/@me

Geçerli hesabı değiştirir ve sonuçtaki kullanıcı nesnesini döndürür. Her alan isteğe bağlıdır; gönderilmeyen alan değiştirilmeden bırakılır. Hiçbir şeyi değiştirmeyen bir gövde hata değildir ve geçerli kullanıcıyı döndürür.

Gövde üç adımda işlenir ve önceki bir adımdaki hata isteği durdurur: önce hesap alanları doğrulanır, sonra kullanıcı adı değişikliği çalışır, ardından profil alanları yazılır ve son olarak hesap alanları saklanır.

JSON gövdesi¶

Kullanıcı adı (sudo doğrulaması gerektirir)

Profil

Hesap

Sınırlar¶

Bir alanın zaten sahip olduğu değeri kaydetmek alan başına haklardan düşülmez.

Yanıt¶

Yan etkiler¶

Hesabın kendi oturumları, üst düzeyde özel kullanıcı nesnesini içeren USER_UPDATE alır. Sunucu üyeleri ve arkadaşlar da profil değişikliğini alır; Gateway, önbellekteki üye verisi değişen sunucular için GUILD_MEMBER_UPDATE türetir. Bkz. Gateway olayları.

curl -X PATCH https://tebhos.com/api/v1/users/@me \
  -H "Authorization: Bearer $TEBHOS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"global_name": "Aria", "pronouns": "she/her", "mention_flags": 2}'

Avatarı değiştir¶

Avatarlar önceden imzalanmış bir URL ile doğrudan depolamaya yüklenir, ardından onaylanır.

Avatar yükleme URL'si oluştur¶

POST /users/@me/avatar/upload-url

Döndürür:

Avatarı onayla¶

POST /users/@me/avatar/confirm

TEBHOS görsel meta verilerini (EXIF, GPS ve benzerleri) temizler, dosyayı içerik hash'i altında saklar ve {"avatar_hash", "image_url"} döndürür. Hareketli bir avatar (baytlardan algılanan GIF, APNG veya hareketli WebP) TEBHOS Pro gerektirir; aksi hâlde 403 ile başarısız olur. Avatar değişiklikleri 30 dakikada 25 ile sınırlıdır (400 INVALID_FORM_BODY, AVATAR_CHANGED_TOO_MANY_TIMES). Başarılı bir değişiklik USER_UPDATE yayınlar.

Avatarı kaldırmak için Geçerli kullanıcıyı değiştir yoluna {"image_url": ""} gönderin.

Genel yükleme akışı için bkz. Yüklemeler.

Afişi değiştir¶

POST /users/@me/banner/upload-url ve POST /users/@me/banner/confirm

Gövdeler, sınırlar ve akış Avatarı değiştir ile aynıdır. Onaylama yolu {"banner_hash", "banner_image_url"} döndürür. Hareketli bir afiş TEBHOS Pro gerektirir. Afiş değişiklikleri 30 dakikada 25 ile sınırlıdır (BANNER_CHANGED_TOO_MANY_TIMES). Afiş hash'i kullanıcı nesnesinde yalnızca hesap Premium'a sahip olduğu sürece görünür.

Yetkili IP'leri unut¶

DELETE /users/@me/authorized-ips

Hesabın tüm yetkili IP kayıtlarını siler; böylece herhangi bir adresten yapılan bir sonraki giriş yeni bir IP yetkilendirmesi gerektirir. Sudo doğrulaması gerektirir; gövde kanıt alanlarını taşır.

Yanıt¶

Hız sınırı¶

Kullanıcı başına 60 saniyede 10 istek, kova user:authorized_ips:forget.

Geçerli hesabı devre dışı bırak¶

POST /auth/account/disable

Hesabı, verilerini koruyarak devre dışı bırakır ve isteği yapan oturum dahil sahip olduğu her oturumu sonlandırır. Yeniden giriş yapmak hesabı yeniden etkinleştirir. Sudo doğrulaması gerektirir.

Yanıt¶

Hız sınırı¶

Kullanıcı başına saatte 5 istek, kova user:account:disable.

Geçerli hesabın silinmesini zamanla¶

POST /auth/account/delete

Hesabı şu andan 14 gün sonra silinecek şekilde zamanlar ve her oturumu sonlandırır. Son tarihten önce giriş yapmak silmeyi iptal eder. Sudo doğrulaması gerektirir.

Yanıt¶

Hız sınırı¶

Kullanıcı başına saatte 5 istek, kova user:account:delete.

curl -X POST https://tebhos.com/api/v1/auth/account/delete \
  -H "Authorization: Bearer $TEBHOS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mfa_code": "123456"}'

Güncel politikaları kabul et¶

POST /users/@me/terms-acceptance

terms_agreed_at ve privacy_agreed_at değerlerini istek zamanına ayarlayarak güncel hizmet şartlarının ve gizlilik politikasının kabul edildiğini kaydeder. Gövde yok sayılır. Güncellenmiş kullanıcı nesnesini döndürür ve hesabın oturumlarına USER_UPDATE yayınlar. Çağrıyı tekrarlamak iki zaman damgasını da yeniler.

Hız sınırı¶

Kullanıcı başına 60 saniyede 20 istek, kova user:update.

Eski profil okumaları¶

TEBHOS web istemcisi ayrıca iki eski, düz profil okuması kullanır. Yeni entegrasyonlar Geçerli kullanıcıyı getir yolunu tercih etmelidir.