İlişkiler¶

İlişki, çağıranın bakış açısından bir arkadaşlığı, engellemeyi veya bekleyen bir arkadaşlık isteğini tanımlar. Özel notlar Kullanıcı notları sayfasına aittir.

Bu sayfadaki tüm yollar yalnızca kullanıcılar içindir. Bir kullanıcı oturum token'ı (Authorization: Bearer <token>) gerektirirler. Geçerli bir Bot <token> kimlik bilgisi 403 ACCESS_DENIED ile, geçersiz olanı ise 401 UNAUTHORIZED ile reddedilir.

İlişki nesnesi¶

Bir ilişki kaydı tek bir hesaba aittir ve başka bir hesabı belirtir. Her alan sahip hesabın tarafını tanımlar ve bu sayfadaki her yol çağıranın kendi kaydını döndürür.

Yapı¶

user nesnesi, iki ek üyesi olan sıradan kısmi kullanıcı nesnesidir:

share_voice_activity her yeni kayıtta false olur. Çağıranın FRIEND kayıtlarında yalnızca çağıran, tüm arkadaşlıklarını aynı anda yeniden yazan Ses etkinliği paylaşımını değiştir ile ses etkinliği paylaşımını açtığında true olur.

Örnek¶

{
  "id": "1501314428688998182",
  "type": 1,
  "relation_type": 1,
  "user": {
    "id": "1501314428688998182",
    "username": "aria",
    "discriminator": "0000",
    "global_name": "Aria",
    "avatar": null,
    "avatar_color": null,
    "flags": 0,
    "name": "Aria",
    "image_url": ""
  },
  "since": "2026-01-14T09:31:00+00:00",
  "nickname": "climbing partner",
  "share_voice_activity": false
}

İlişki türleri¶

Toplu yok sayma sonuç nesnesi¶

Toplu yok sayma sonucu, tek bir çağrının kaç gelen arkadaşlık isteğini kaldırdığını bildirir.

Yapı¶

Toplu yok sayma filtreleri¶

new_accounts eşleşmeyi yalnızca max_account_age_seconds de verildiğinde daraltır. Bu değer olmadan ve new_accounts dışındaki her değerde çağrı all gibi davranır.

İlişki sınırı¶

Bir hesap; arkadaşlıklar, engellemeler ve her iki yöndeki bekleyen istekler dahil toplamda en fazla 1000 ilişki kaydı tutabilir. Sınır sabittir ve örnek (instance) tarafından yapılandırılamaz.

TEBHOS, yeni bir arkadaşlık isteği oluşturulurken ve bekleyen bir istek kabul edilirken çağıranı ve hedefi ayrı ayrı denetler. Hesaplardan biri sınıra ulaştıysa istek 400 MAX_FRIENDS ile başarısız olur. Engelleme bu sınıra tabi değildir.

İlişkileri listele¶

GET /users/@me/relationships

Çağıranın tuttuğu her ilişki nesnesini döndürür; arkadaşlıkları, engellemeleri ve her iki yöndeki bekleyen istekleri kapsar.

İşlem sayfalanmaz ve kümenin tamamı tek bir yanıtta gelir. Sıralamaya güvenilemez. Bağlı bir istemci aynı kümeyi Gateway Ready yükünde de alır.

Yanıt¶

Hız sınırı¶

user:relationships:list kovasında, kimliği doğrulanmış her kullanıcı için 10 saniyede 40 istek.

Kullanıcı adıyla arkadaşlık isteği gönder¶

POST /users/@me/relationships

Kullanıcı adıyla belirtilen hesaba bir arkadaşlık isteği gönderir. Başarılı olursa bir ilişki nesnesi döndürür.

TEBHOS kullanıcı adları benzersizdir; bu yüzden hedef yalnızca kullanıcı adıyla bulunur ve bir ayırıcı (discriminator) alanı yoktur. Arama büyük/küçük harf duyarsızdır ve baştaki ve sondaki boşlukları yok sayar. Aramadan sonraki tüm kurallar Kullanıcı kimliğiyle arkadaşlık isteği gönder bölümünde açıklananlardır.

JSON gövdesi¶

Yanıt¶

Yan etkiler¶

Yan etkiler, Kullanıcı kimliğiyle arkadaşlık isteği gönder ucununkilerle aynıdır.

Hız sınırı¶

user:friend_request:send kovasında, kimliği doğrulanmış her kullanıcı için 60 saniyede 10 istek; Kullanıcı kimliğiyle arkadaşlık isteği gönder ile paylaşılır.

Kullanıcı kimliğiyle arkadaşlık isteği gönder¶

POST /users/@me/relationships/{user_id}

Seçilen hesaba bir arkadaşlık isteği gönderir. Başarılı olursa bir ilişki nesnesi döndürür. Yol hiçbir istek gövdesi okumaz.

TEBHOS isteği şu sırayla değerlendirir:

1. Tamsayı olmayan bir user_id 400 BAD_REQUEST, hiçbir hesabı belirtmeyen bir kimlik 404 NOT_FOUND döndürür.
2. Çağıranın kendi kimliği 400 CANNOT_SEND_FRIEND_REQUEST_TO_SELF döndürür.
3. Çağıranın hedefle mevcut kaydı sonraki adımı belirler:
   • INCOMING_REQUEST: bekleyen istek, tam olarak Arkadaşlık isteğini kabul et veya kullanıcıyı engelle ucunun yapacağı gibi kabul edilir ve ortaya çıkan FRIEND kaydı döndürülür.
   • OUTGOING_REQUEST: mevcut istek değiştirilmeden döndürülür.
   • FRIEND: 400 ALREADY_FRIENDS.
   • BLOCKED (çağıran hedefi engellemiş): 400 CANNOT_SEND_FRIEND_REQUEST_TO_BLOCKED_USER.
4. Çağıranı engellemiş bir hedef 400 FRIEND_REQUEST_BLOCKED döndürür. Kod, aşağıdaki gizlilik reddiyle aynıdır; bu yüzden çağıran engellendiğini anlayamaz.
5. Hedefin arkadaşlık isteği gizlilik ayarı (kullanıcı ayarlarındaki arkadaşlık kaynağı bayrakları) denetlenir. Yalnızca arkadaşlarının arkadaşlarından veya ortak bir sunucunun üyelerinden istek kabul eden bir hedef, ilgisiz bir çağıranı 400 FRIEND_REQUEST_BLOCKED ile reddeder.
6. İlişki sınırı her iki hesap için denetlenir.

4–6. adımlar yalnızca gerçekten yeni bir isteğe uygulanır. Bekleyen bir gelen isteğin kabul edilmesi (3. adım) ilişki sınırını yine denetler ama gizlilik ayarını denetlemez.

Yol parametreleri¶

Yanıt¶

Yan etkiler¶

Yeni bir istek, çağıran için bir OUTGOING_REQUEST kaydı ve hedef için bir INCOMING_REQUEST kaydı yazar ve her iki hesaba, her birine kendi kaydıyla birlikte Relationship Add gönderir.

Hedef çağırana zaten bir istek göndermişse, bekleyen her iki kayıt da FRIEND kayıtlarıyla değiştirilir ve Relationship Update her iki hesaba ulaşır.

Mevcut bir giden isteğin döndürülmesi hiçbir şey yazmaz ve hiçbir olay göndermez.

Bu yoldaki hiçbir akış bir doğrudan mesaj kanalı açmaz.

Hız sınırı¶

user:friend_request:send kovasında, kimliği doğrulanmış her kullanıcı için 60 saniyede 10 istek; Kullanıcı adıyla arkadaşlık isteği gönder ile paylaşılır.

Arkadaşlık isteğini kabul et veya kullanıcıyı engelle¶

PUT /users/@me/relationships/{user_id}

Bekleyen bir gelen arkadaşlık isteğini kabul eder ya da gövde BLOCKED seçtiğinde seçilen hesabı engeller. Çağıranın ortaya çıkan ilişki nesnesini döndürür.

user_id hatalı biçimliyse veya çağıranın kendi kimliğiyse her iki işlem de 400 BAD_REQUEST, hiçbir hesabı belirtmiyorsa 404 NOT_FOUND döndürür.

Kabul, çağıranın hedef için bir INCOMING_REQUEST kaydı yoksa 404 UNKNOWN_USER döndürür; ardından ilişki sınırını her iki hesaba uygular.

Engellemenin başka kabul kuralı yoktur. İlişki sınırına veya hedefin gizlilik ayarlarına tabi değildir.

Yol parametreleri¶

JSON gövdesi¶

Gövde gönderilmeyebilir; bu durumda kabul seçilir.

Yanıt¶

Yan etkiler¶

Kabul, her iki hesaptaki bekleyen kayıtları FRIEND kayıtlarıyla değiştirir, since değerini geçerli zamana ayarlar ve her iki hesaba Relationship Update gönderir. Doğrudan mesaj kanalı açmaz; iki taraf da Özel kanal oluştur ile bir kanal açabilir.

Engelleme, her iki hesaptaki mevcut kayıtları (arkadaşlık veya her iki yöndeki bekleyen istek) siler ve yalnızca çağıran için bir BLOCKED kaydı yazar. Relationship Add engellemeyle birlikte çağırana, Relationship Remove ise çağıranın kimliğiyle birlikte hedefe ulaşır. Remove, hedefin hiç kaydı olmasa bile gönderilir. Zaten engellenmiş bir hesabı engellemek aynı kaydı yeniden yazar. Engelleme, çiftin doğrudan mesaj kanalını hiçbir zaman kapatmaz veya silmez.

Hız sınırı¶

user:friend_request:accept kovasında, kimliği doğrulanmış her kullanıcı için 10 saniyede 20 istek.

İlişkiyi kaldır¶

DELETE /users/@me/relationships/{user_id}

Çağıranın seçilen hesapla olan arkadaşlığını, her iki yöndeki bekleyen arkadaşlık isteğini veya engellemesini kaldırır. Başarılı olursa boş gövdeyle 204 döndürür.

Yol hiçbir istek gövdesi okumaz. Neyin kaldırılacağını çağıranın mevcut kaydı belirler; böylece aynı yol arkadaşlıktan çıkarır, isteği iptal eder veya reddeder ve engeli kaldırır.

Yol parametreleri¶

Yanıt¶

Yan etkiler¶

Bir arkadaşlığın veya her iki yöndeki bekleyen bir isteğin kaldırılması her iki hesabın kaydını da siler ve her ikisine, id içinde diğer hesabın kimliğini taşıyan Relationship Remove gönderir. Dolayısıyla gelen bir isteği reddetmek gönderenin OUTGOING_REQUEST kaydını da kaldırır ve gönderen bilgilendirilir.

Engelleme yalnızca tek bir hesapta saklanır; bu yüzden bir engellemeyi kaldırmak çağıranın kaydını siler ve Relationship Remove olayını yalnızca çağırana gönderir.

Hız sınırı¶

user:relationship:delete kovasında, kimliği doğrulanmış her kullanıcı için 10 saniyede 30 istek.

İlişki takma adını değiştir¶

PATCH /users/@me/relationships/{user_id}

Çağıranın bir arkadaşı için özel takma adını ayarlar veya temizler. Güncellenmiş ilişki nesnesini döndürür. Çağırana bir Relationship Update Gateway olayı gönderir.

Yalnızca FRIEND kaydı takma ad kabul eder. Diğer tüm ilişki durumları 404 NOT_FOUND döndürür.

Yol parametreleri¶

JSON gövdesi¶

Değer gönderildiği gibi saklanır. Sunucu değeri kırpmaz ve düz bir boş dize temizlenmez, boş dize olarak saklanır.

Yanıt¶

Yan etkiler¶

Kayıt yalnızca çağıran için değişir ve share_voice_activity saklanan değerini korur. Saklanan bir since değeri korunur; değeri olmayan bir kayda geçerli zaman damgası basılır. Relationship Update, zaten saklanan değeri gönderenler dahil kabul edilen her istek için çağırana ulaşır.

Hız sınırı¶

user:relationship:update kovasında, kimliği doğrulanmış her kullanıcı için 10 saniyede 30 istek.

Bekleyen istekleri toplu yok say¶

POST /users/@me/relationships/bulk-ignore

Eşleşen gelen arkadaşlık isteklerini kaldırır. Başarılı olursa bir toplu yok sayma sonucu nesnesi döndürür.

Eşleştirme yalnızca çağıranın INCOMING_REQUEST kayıtlarına uygulanır. TEBHOS, bir gönderenin hesap yaşını snowflake değerine gömülü zaman damgasından türetir ve bunu hariç tutan bir üst sınır olarak max_account_age_seconds ile karşılaştırır; bu yüzden tam olarak o yaşta olan bir gönderen eşleşmez. Tek bir çağrı eşleşen tüm istekleri kaldırır.

JSON gövdesi¶

Gövde gönderilmeyebilir; bu durumda all filtresi uygulanır.

Yanıt¶

Yan etkiler¶

Eşleşen her istek, çağıranın INCOMING_REQUEST kaydını ve gönderenin OUTGOING_REQUEST kaydını kaldırır ve hem çağırana hem gönderene Relationship Remove gönderir. Hiçbir şeyle eşleşmeyen bir çağrı hiçbir şeyi değiştirmez.

Yarıda başarısız olan bir çağrı bazı gelen arkadaşlık isteklerini kaldırmış olabilir ve hiçbir sayı döndürmez. Kalanları okumak için İlişkileri listele ucunu yeniden çağırın.

Hız sınırı¶

relationship:bulk_ignore kovasında, kimliği doğrulanmış her kullanıcı için 60 saniyede 5 istek.

Gateway olayları¶

Her ilişki Dispatch'i yalnızca belirttiği hesabın oturumlarına gider:

Zarf için bkz. Gateway olayları.