Kullanıcı ayarları¶

Kullanıcı ayarları, hesap genelindeki tercihleri ve her sunucu ile özel kanallar için tutulan bildirim ayarlarını kapsar.

Bu sayfadaki her yol bir kullanıcı oturumu gerektirir. Geçerli bir bot token'ı 403 ACCESS_DENIED ile reddedilir.

Durum (presence) değerleri¶

offline, etkin oturumu olmayan bir hesabı tanımlar ve saklanamaz.

Tema değerleri¶

Bildirim düzeyleri¶

Sessize alma yapılandırması nesnesi¶

Saklanan bir sessize alma yapılandırması yoksa yanıtlar {"end_time": null, "selected_time_window": null} içerir. Geçmişte kalmış bir end_time artık sessize almaz, ancak yanıtta kalabilir.

Kanal bildirim geçersiz kılma nesnesi¶

Tek bir kanal için bildirim ayarları.

Hiç yazılmamış alanlar null olarak döndürülür.

Kullanıcı sunucu ayarları nesnesi¶

Tek bir sunucu için ya da guild_id null olduğunda tüm doğrudan mesajlar ve grup DM'ler için bildirim ayarları.

{
  "guild_id": null,
  "message_notifications": 1,
  "muted": false,
  "mute_config": { "end_time": null, "selected_time_window": null },
  "mobile_push": true,
  "suppress_everyone": false,
  "suppress_roles": false,
  "hide_muted_channels": false,
  "channel_overrides": null,
  "unread_badges": null,
  "version": 4
}

Sunucu ayarları güncelleme alanları¶

Sunucu bildirim ayarlarını değiştir isteğinin gövdesi. Her alan isteğe bağlıdır; atlanan alan değişmeden kalır.

Sessize alma yapılandırması girdi nesnesi¶

Kanal geçersiz kılma girdi nesnesi¶

Harita anahtarları kanal kimlikleri olmalıdır; sayısal olmayan bir anahtar 400 döndürür.

Kullanıcı ayarları güncelleme nesnesi¶

Geçerli kullanıcı ayarlarını değiştir isteğinin gövdesi. Her alan isteğe bağlıdır. Atlanan alan değişmeden kalır; bulunan alan doğrulanır ve yazılır, geçersiz bir değer ise isteğin tamamını 400 ile başarısız kılar (TEBHOS hiçbir alanı sessizce atlamaz). Alanlar {"settings": {...}} biçiminde sarmalanarak da gönderilebilir.

Snowflake dizileri dize veya sayısal kimlik kabul eder; yinelenenler kaldırılır.

Dil kodları: ar, bg, cs, da, de, el, en-GB, en-US, es-ES, es-419, fi, fr, he, hi, hr, hu, id, it, ja, ko, lt, nl, no, pl, pt-BR, ro, ru, sv-SE, th, tr, uk, vi, zh-CN, zh-TW. TEBHOS web istemcisi şu an en-US ve tr dillerine çevrilmiştir; bkz. Diller.

Sunucu klasörü girdi nesnesi¶

Gönderilen düzende kategorisiz klasör yoksa başa boş bir tane eklenir. Birden çok kez görünen bir sunucu kimliği yalnız tek bir yerde tutulur: adı boş olmayan klasör adsız olana, sıradan klasör kategorisiz klasöre üstün gelir; eşitlikte ilk görünen kazanır. İstemcinin gösteremediği sunucu kimlikleri de dizide tutulmalıdır; dışarıda bırakılan her şey saklanan düzenden kaldırılır.

Özel durum girdi nesnesi¶

Ne metin ne de emoji içeren bir nesne durumu temizler. Emoji kimliği verildiği gibi saklanır ve çözümlenmez.

Başlangıç ayarları¶

TEBHOS kayıt sırasında bir ayar kaydı yazmaz; hiç yazılmamış bir alan şu değerle döndürülür.

Geçerli kullanıcı ayarlarını al¶

GET /users/@me/settings

Kullanıcı ayarları nesnesini döndürür. Hiçbir ayarı değiştirmemiş bir hesap başlangıç değerlerini alır.

Hız sınırı¶

Kullanıcı başına 10 saniyede 40 istek, user:settings:get kovası; Geçerli kullanıcıyı al ile paylaşılır.

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

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

PATCH /users/@me/settings

Kullanıcı ayarları güncelleme nesnesini uygular ve eksiksiz kullanıcı ayarları nesnesini döndürür. PUT aynı şekilde davranır.

Yanıt¶

Yan etkiler¶

Hiçbir şey değişmemiş olsa bile çağıranın oturumları tam ayar nesnesiyle USER_SETTINGS_UPDATE alır. Gateway özel durumu çağıranın durumuna (presence) uygular. invisible durumu çağıranın her oturumunu görünmez yapar; daha sonra gelen online, idle veya dnd bunu geri alır. Bkz. Gateway olayları.

Hız sınırı¶

Kullanıcı başına 10 saniyede 20 istek, user:settings:update kovası; Ses etkinliği paylaşımını değiştir ile paylaşılır.

curl -X PATCH https://tebhos.com/api/v1/users/@me/settings \
  -H "Authorization: Bearer $TEBHOS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": "dnd", "custom_status": {"text": "Focusing", "emoji_name": "🎧"}}'

Ses etkinliği paylaşımını değiştir¶

PUT /users/@me/settings/voice-activity-sharing

Varsayılan ses etkinliği paylaşımı değerini ayarlar, bunu her arkadaşlığın çağırana ait tarafına uygular ve çağıranın kullanıcı nesnesini döndürür.

JSON gövdesi¶

Bekleme süresi¶

Değer 24 saatte bir değiştirilebilir. Bu süre içindeki bir istek, geçerli değeri yineleyen istek dahil, 429 ve kalan saniyeleri taşıyan bir Retry-After başlığıyla başarısız olur. Kullanıcı nesnesindeki last_voice_activity_sharing_change_at, kabul edilen son değişikliği kaydeder.

Yanıt¶

Yan etkiler¶

Her arkadaşlık için çağıran ve arkadaşı ayrı ayrı RELATIONSHIP_UPDATE alır. Çağıran USER_UPDATE alır; saklanan varsayılan değiştiyse ayrıca USER_SETTINGS_UPDATE alır.

Hız sınırı¶

Kullanıcı başına 10 saniyede 20 istek, user:settings:update kovası.

Sunucu bildirim ayarlarını listele¶

GET /users/@me/guilds/settings

Saklanan her kullanıcı sunucu ayarları nesnesinden oluşan bir dizi döndürür; yazılmışsa özel kanal ayarları da dahildir.

Sunucu bildirim ayarlarını al¶

GET /users/@me/guilds/{guild_id}/settings

Tek bir sunucu için kullanıcı sunucu ayarları nesnesini döndürür. Doğrudan mesaj ve grup DM ayarları için guild_id olarak @me (veya 0) kullanılır. Hiç yazılmamış ayarlar varsayılanları ve version 0 ile döndürülür.

Sunucu bildirim ayarlarını değiştir¶

PATCH /users/@me/guilds/{guild_id}/settings

Sunucu ayarları güncelleme alanlarını uygular ve ortaya çıkan kullanıcı sunucu ayarları nesnesini döndürür. Özel kanal ayarları için guild_id olarak @me (veya 0) kullanılır; bunlar guild_id null olarak döndürülür. Ayarlar yoksa varsayılanlarla oluşturulur.

Yan etkiler¶

Her başarılı yazmada çağıranın oturumları, ayar nesnesi ve user_id ile birlikte USER_GUILD_SETTINGS_UPDATE alır.

Hız sınırı¶

Kullanıcı başına 10 saniyede 30 istek, user:guild_settings:update kovası.

curl -X PATCH https://tebhos.com/api/v1/users/@me/guilds/1501314428688998100/settings \
  -H "Authorization: Bearer $TEBHOS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message_notifications": 1, "suppress_everyone": true}'

Eski ayar görünümleri¶

TEBHOS web istemcisinin eski ayar sekmeleri, aynı ayar kaydının uyumluluk görünümlerini okur ve yazar. Yeni entegrasyonlar yukarıdaki yolları kullanmalıdır.

Bu görünümlerden biri üzerinden yapılan değişiklik, kullanıcı ayarları nesnesinin eşlenen alanlarını günceller ve USER_SETTINGS_UPDATE yayar.