REST referansı

Üyeler

Son güncelleme: 11 Kasım 2026

.md indir Markdown aç .html indirTam PDF

Bu sayfada

Üyeleri listele
Üyeyi getir
Üyeyi güncelle
Üyeyi çıkar
Üyeye rol ver
Üyeden rol al

Üyeleri listele

GET/guilds/{guild_id}/members

Üyeleri kullanıcı ID'sine göre sıralı döndürür. Sayfalamak için after'a son aldığın kullanıcı ID'sini ver. limit 1 ile 1000 arasındadır, varsayılanı 100'dür. Bot için GUILD_MEMBERS intent'i gerekir.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: read 30 istek / 5 sn

Parametreler

Ad	Tür	Açıklama
`guild_id`zorunlu	string	Adreste Sunucu ID'si.
`limit`	integer	Sorguda Kaç üye döneceği. 1–1000 · = 100
`after`	ID	Sorguda Kullanıcı ID'si bundan büyük üyeleri döndürür.

Örnek istek

curl "https://noluyo.net/api/v1/guilds/111500000000000000/members?limit=100" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

200 Başarılı

JSON

[
  {
    "user": {
      "id": "111400000000000000",
      "username": "ayse",
      "display_name": "Ayşe",
      "avatar": null,
      "cosmetics": null
    },
    "nick": null,
    "roles": [],
    "joined_at": "2026-11-04T16:21:11.569Z",
    "mute": false,
    "deaf": false,
    "communication_disabled_until": null
  }
]

Hatalar

Durum	Kodlar
400	validation_failed
401	unauthorized
403	temporarily_banned member_list_intent_required
404	unknown_guild
429	rate_limited
503	maintenance

Üyeyi getir

GET/guilds/{guild_id}/members/{user_id}

Tek bir üyeyi döndürür. Çağıranın kendisi için user_id @me olabilir.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: read 30 istek / 5 sn

Parametreler

Ad	Tür	Açıklama
`guild_id`zorunlu	string	Adreste Sunucu ID'si.
`user_id`zorunlu	string	Adreste Üyenin kullanıcı ID'si ya da çağıran için @me.

Örnek istek

curl -X GET "https://noluyo.net/api/v1/guilds/111500000000000000/members/@me" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

200 Başarılı

JSON

{
  "user": {
    "id": "111400000000000000",
    "username": "ayse",
    "display_name": "Ayşe",
    "avatar": null,
    "cosmetics": null
  },
  "nick": null,
  "roles": [],
  "joined_at": "2026-11-04T16:21:11.569Z",
  "mute": false,
  "deaf": false,
  "communication_disabled_until": null
}

Hatalar

Durum	Kodlar
401	unauthorized
403	temporarily_banned
404	unknown_guild unknown_member
429	rate_limited
503	maintenance

Üyeyi güncelle

PATCH/guilds/{guild_id}/members/{user_id}

Yalnızca gönderilen alanları değiştirir. nick, kişinin kendisi için ChangeNickname, başkası için ManageNicknames ve daha yüksek rütbe ister. roles üyenin tüm rol listesini değiştirir ve ManageRoles ister; eklenen veya çıkarılan her rol çağıranın altında olmalı, yönetilen rol ya da @everyone olmamalıdır. mute MuteMembers, deaf DeafenMembers ister. communication_disabled_until, ModerateMembers ve daha yüksek rütbe ister: en çok 28 gün sonrası bir zaman üyeyi susturur, null ya da geçmiş bir zaman susturmayı bitirir; sahip ve yöneticiler susturulamaz. channel_id, MoveMembers ister ve seste olan üyeyi başka bir ses kanalına taşır, null ise sesten düşürür.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
İzinler: ChangeNickname ManageNicknames ManageRoles MuteMembers DeafenMembers ModerateMembers MoveMembersBirden çok izin varsa bazıları yalnızca belirli durumlarda gerekir; yukarıdaki açıklamaya bak.
Hız sınırı: write 10 istek / 10 sn

Parametreler

Ad	Tür	Açıklama
`guild_id`zorunlu	string	Adreste Sunucu ID'si.
`user_id`zorunlu	string	Adreste Üyenin kullanıcı ID'si ya da çağıran için @me.

Gövde alanları

Ad	Tür	Açıklama
`nick`	string \| null	≤ 32
`roles`	ID[]
`mute`	boolean
`deaf`	boolean
`communication_disabled_until`	string \| null
`channel_id`	ID \| null

Örnek istek

curl -X PATCH "https://noluyo.net/api/v1/guilds/111500000000000000/members/111400000000000000" \
  -H "Authorization: Bot $BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"nick":"Ayşe (mod)"}'

Örnek gövde

application/json

{
  "nick": "Ayşe (mod)",
  "communication_disabled_until": "2026-11-05T12:00:00Z"
}

Örnek yanıt

200 Başarılı

JSON

{
  "user": {
    "id": "111400000000000000",
    "username": "ayse",
    "display_name": "Ayşe",
    "avatar": null,
    "cosmetics": null
  },
  "nick": "Ayşe (mod)",
  "roles": [],
  "joined_at": "2026-11-04T16:21:11.569Z",
  "mute": false,
  "deaf": false,
  "communication_disabled_until": "2026-11-05T12:00:00Z"
}

Hatalar

Durum	Kodlar
400	validation_failed invalid_body managed_role cannot_target_self not_in_voice
401	unauthorized
403	missing_permissions role_hierarchy cannot_timeout temporarily_banned
404	unknown_guild unknown_member
413	body_too_large
429	rate_limited
503	voice_unavailable maintenance

Üyeyi çıkar

DELETE/guilds/{guild_id}/members/{user_id}

Çağıranın üstünde olduğu bir üyeyi sunucudan çıkarır. Kendin ayrılmak için DELETE /users/@me/guilds/{guild_id} kullan. Bot çıkarılırsa yönetilen rolü de silinir.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
İzinler: KickMembers
Hız sınırı: write 10 istek / 10 sn

Parametreler

Ad	Tür	Açıklama
`guild_id`zorunlu	string	Adreste Sunucu ID'si.
`user_id`zorunlu	string	Adreste Üyenin kullanıcı ID'si ya da çağıran için @me.

Örnek istek

curl -X DELETE "https://noluyo.net/api/v1/guilds/111500000000000000/members/111400000000000000" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

204 Başarılı; yanıtın gövdesi yok.

Hatalar

Durum	Kodlar
400	cannot_target_self
401	unauthorized
403	missing_permissions role_hierarchy temporarily_banned
404	unknown_guild unknown_member
429	rate_limited
503	maintenance

Üyeye rol ver

PUT/guilds/{guild_id}/members/{user_id}/roles/{role_id}

Çağıranın altındaki tek bir rolü verir. Yönetilen roller ve @everyone verilemez. İstek gövdesi yoktur.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
İzinler: ManageRoles
Hız sınırı: write 10 istek / 10 sn

Parametreler

Ad	Tür	Açıklama
`guild_id`zorunlu	string	Adreste Sunucu ID'si.
`user_id`zorunlu	string	Adreste Üyenin kullanıcı ID'si ya da çağıran için @me.
`role_id`zorunlu	string	Adreste Rol ID'si.

Örnek istek

curl -X PUT "https://noluyo.net/api/v1/guilds/111500000000000000/members/111400000000000000/roles/111550000000000200" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

204 Başarılı; yanıtın gövdesi yok.

Hatalar

Durum	Kodlar
400	everyone_role managed_role
401	unauthorized
403	missing_permissions role_hierarchy temporarily_banned
404	unknown_guild unknown_member unknown_role
429	rate_limited
503	maintenance

Üyeden rol al

DELETE/guilds/{guild_id}/members/{user_id}/roles/{role_id}

Çağıranın altındaki tek bir rolü alır. Yönetilen roller ve @everyone alınamaz.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
İzinler: ManageRoles
Hız sınırı: write 10 istek / 10 sn

Parametreler

Ad	Tür	Açıklama
`guild_id`zorunlu	string	Adreste Sunucu ID'si.
`user_id`zorunlu	string	Adreste Üyenin kullanıcı ID'si ya da çağıran için @me.
`role_id`zorunlu	string	Adreste Rol ID'si.

Örnek istek

curl -X DELETE "https://noluyo.net/api/v1/guilds/111500000000000000/members/111400000000000000/roles/111550000000000200" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

204 Başarılı; yanıtın gövdesi yok.

Hatalar

Durum	Kodlar
400	everyone_role managed_role
401	unauthorized
403	missing_permissions role_hierarchy temporarily_banned
404	unknown_guild unknown_member unknown_role
429	rate_limited
503	maintenance