Üyeler

Üyeler için REST API rotaları.

Üyeleri listele (`listMembers`)

GET https://noluyo.net/api/v1/guilds/{guild_id}/members (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'ı (Authorization: Bot <BOT_TOKEN>)
Hız sınırı: read (30 / 5s)

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama
`guild_id`	`path`	`string`	evet	Sunucu ID'si.
`limit`	`query`	`integer`	-	Kaç üye döneceği. (1–1000 · = 100)
`after`	`query`	`ID`	-	Kullanıcı ID'si bundan büyük üyeleri döndürür.

Örnek çağrılar

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

// JavaScript (noluyo-bot)
await bot.rest.listMembers("111500000000000000", { limit: 100 });

# Python (noluyo_bot)
await bot.rest.list_members("111500000000000000", {"limit": 100})

Yanıt (200)

[
  {
    "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
  }
]

Hata kodları

HTTP 400: validation_failed
HTTP 401: unauthorized
HTTP 403: temporarily_banned, member_list_intent_required
HTTP 404: unknown_guild
HTTP 429: rate_limited
HTTP 503: maintenance

Üyeyi getir (`getMember`)

GET https://noluyo.net/api/v1/guilds/{guild_id}/members/{user_id} (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'ı (Authorization: Bot <BOT_TOKEN>)
Hız sınırı: read (30 / 5s)

Parametreler

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

Örnek çağrılar

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

// JavaScript (noluyo-bot)
await bot.rest.getMember("111500000000000000", "@me");

# Python (noluyo_bot)
await bot.rest.get_member("111500000000000000", "@me")

Yanıt (200)

{
  "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
}

Hata kodları

HTTP 401: unauthorized
HTTP 403: temporarily_banned
HTTP 404: unknown_guild, unknown_member
HTTP 429: rate_limited
HTTP 503: maintenance

Üyeyi güncelle (`updateMember`)

PATCH https://noluyo.net/api/v1/guilds/{guild_id}/members/{user_id} (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'ı (Authorization: Bot <BOT_TOKEN>)
İzinler: ChangeNickname, ManageNicknames, ManageRoles, MuteMembers, DeafenMembers, ModerateMembers, MoveMembers
Hız sınırı: write (10 / 10s)

Parametreler

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

Gövde alanları

Alan	Tür	Zorunlu	Açıklama
`nick`	`string \| null`	-	(<= 32)
`roles`	`ID[]`	-
`mute`	`boolean`	-
`deaf`	`boolean`	-
`communication_disabled_until`	`string \| null`	-
`channel_id`	`ID \| null`	-

Örnek çağrılar

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)"}'

// JavaScript (noluyo-bot)
await bot.rest.updateMember("111500000000000000", "111400000000000000", { nick: "Ayşe (mod)" });

# Python (noluyo_bot)
await bot.rest.update_member("111500000000000000", "111400000000000000", {"nick": "Ayşe (mod)"})

Yanıt (200)

{
  "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"
}

Hata kodları

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

Üyeyi çıkar (`kickMember`)

DELETE https://noluyo.net/api/v1/guilds/{guild_id}/members/{user_id} (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'ı (Authorization: Bot <BOT_TOKEN>)
İzinler: KickMembers
Hız sınırı: write (10 / 10s)

Parametreler

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

Örnek çağrılar

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

// JavaScript (noluyo-bot)
await bot.rest.kickMember("111500000000000000", "111400000000000000");

# Python (noluyo_bot)
await bot.rest.kick_member("111500000000000000", "111400000000000000")

Yanıt (204)

Yanıt gövdesi yok.

Hata kodları

HTTP 400: cannot_target_self
HTTP 401: unauthorized
HTTP 403: missing_permissions, role_hierarchy, temporarily_banned
HTTP 404: unknown_guild, unknown_member
HTTP 429: rate_limited
HTTP 503: maintenance

Üyeye rol ver (`addMemberRole`)

PUT https://noluyo.net/api/v1/guilds/{guild_id}/members/{user_id}/roles/{role_id} (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'ı (Authorization: Bot <BOT_TOKEN>)
İzinler: ManageRoles
Hız sınırı: write (10 / 10s)

Parametreler

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

Örnek çağrılar

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

// JavaScript (noluyo-bot)
await bot.rest.addMemberRole("111500000000000000", "111400000000000000", "111550000000000200");

# Python (noluyo_bot)
await bot.rest.add_member_role("111500000000000000", "111400000000000000", "111550000000000200")

Yanıt (204)

Yanıt gövdesi yok.

Hata kodları

HTTP 400: everyone_role, managed_role
HTTP 401: unauthorized
HTTP 403: missing_permissions, role_hierarchy, temporarily_banned
HTTP 404: unknown_guild, unknown_member, unknown_role
HTTP 429: rate_limited
HTTP 503: maintenance

Üyeden rol al (`removeMemberRole`)

DELETE https://noluyo.net/api/v1/guilds/{guild_id}/members/{user_id}/roles/{role_id} (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'ı (Authorization: Bot <BOT_TOKEN>)
İzinler: ManageRoles
Hız sınırı: write (10 / 10s)

Parametreler

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

Örnek çağrılar

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

// JavaScript (noluyo-bot)
await bot.rest.removeMemberRole("111500000000000000", "111400000000000000", "111550000000000200");

# Python (noluyo_bot)
await bot.rest.remove_member_role("111500000000000000", "111400000000000000", "111550000000000200")

Yanıt (204)

Yanıt gövdesi yok.

Hata kodları

HTTP 400: everyone_role, managed_role
HTTP 401: unauthorized
HTTP 403: missing_permissions, role_hierarchy, temporarily_banned
HTTP 404: unknown_guild, unknown_member, unknown_role
HTTP 429: rate_limited
HTTP 503: maintenance

Üyeler

Üyeleri listele (listMembers)

Parametreler

Örnek çağrılar

Yanıt (200)

Hata kodları

Üyeyi getir (getMember)

Parametreler

Örnek çağrılar

Yanıt (200)

Hata kodları

Üyeyi güncelle (updateMember)

Parametreler

Gövde alanları

Örnek çağrılar

Yanıt (200)

Hata kodları

Üyeyi çıkar (kickMember)

Parametreler

Örnek çağrılar

Yanıt (204)

Hata kodları

Üyeye rol ver (addMemberRole)

Parametreler

Örnek çağrılar

Yanıt (204)

Hata kodları

Üyeden rol al (removeMemberRole)

Parametreler

Örnek çağrılar

Yanıt (204)

Hata kodları

Üyeleri listele (`listMembers`)

Üyeyi getir (`getMember`)

Üyeyi güncelle (`updateMember`)

Üyeyi çıkar (`kickMember`)

Üyeye rol ver (`addMemberRole`)

Üyeden rol al (`removeMemberRole`)