REST referansı

Roller

Son güncelleme: 11 Kasım 2026

.md indir Markdown aç .html indirTam PDF

Bu sayfada

Sunucunun rollerini listele
Rol oluştur
Rolü güncelle
Rolü sil

Sunucunun rollerini listele

GET/guilds/{guild_id}/roles

Sunucunun, @everyone ve botların yönetilen rolleri dâhil tüm rollerini döndürür. @everyone rolünün ID'si sunucunun ID'siyle aynıdır.

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.

Örnek istek

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

Örnek yanıt

200 Başarılı

JSON

[
  {
    "id": "111500000000000000",
    "name": "@everyone",
    "color": 0,
    "hoist": false,
    "mentionable": false,
    "position": 0,
    "permissions": "1071698529857",
    "auto_assign": false
  },
  {
    "id": "111550000000000000",
    "name": "Örnek Bot",
    "color": 0,
    "hoist": false,
    "mentionable": false,
    "position": 1,
    "permissions": "68672",
    "auto_assign": false,
    "application_id": "111540000000000000"
  }
]

Hatalar

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

Rol oluştur

POST/guilds/{guild_id}/roles

Doğrudan @everyone'ın üstünde bir rol oluşturur. Gövde zorunludur; yalnızca {} bile olabilir. position burada yok sayılır; ad verilmezse rolün adı "yeni rol" olur. Kimse sahip olmadığı bir izni veremez.

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.

Gövde alanları

Ad	Tür	Açıklama
`name`	string	1–100
`color`	integer	0–16777215
`hoist`	boolean
`mentionable`	boolean
`position`	integer	Yalnızca güncellemede.
`permissions`	permissions	Ondalık metin olarak izin bit alanı. Metin yerine sayı veya tanımlı olmayan bitler `invalid_body` verir.
`auto_assign`	boolean

Örnek istek

curl -X POST "https://noluyo.net/api/v1/guilds/111500000000000000/roles" \
  -H "Authorization: Bot $BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"name":"Moderatör","color":3447003}'

Örnek gövde

application/json

{
  "name": "Moderatör",
  "color": 3447003,
  "hoist": true,
  "mentionable": true,
  "permissions": "8192"
}

Örnek yanıt

201 Başarılı

JSON

{
  "id": "111550000000000200",
  "name": "Moderatör",
  "color": 3447003,
  "hoist": true,
  "mentionable": true,
  "position": 1,
  "permissions": "8192",
  "auto_assign": false
}

Hatalar

Durum	Kodlar
400	validation_failed invalid_body max_roles
401	unauthorized
403	missing_permissions temporarily_banned
404	unknown_guild
413	body_too_large
429	rate_limited
503	maintenance

Rolü güncelle

PATCH/guilds/{guild_id}/roles/{role_id}

Yalnızca gönderilen alanları değiştirir. Çağıran rolün üstünde olmalı, position da çağıranın en yüksek rolünün altında kalmalıdır. Yeni izin bitleri çağıranda bulunmalıdır. @everyone için name, position ve auto_assign, yönetilen rol için auto_assign true reddedilir.

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.
`role_id`zorunlu	string	Adreste Rol ID'si.

Gövde alanları

Ad	Tür	Açıklama
`name`	string	1–100
`color`	integer	0–16777215
`hoist`	boolean
`mentionable`	boolean
`position`	integer	Yalnızca güncellemede.
`permissions`	permissions	Ondalık metin olarak izin bit alanı. Metin yerine sayı veya tanımlı olmayan bitler `invalid_body` verir.
`auto_assign`	boolean

Örnek istek

curl -X PATCH "https://noluyo.net/api/v1/guilds/111500000000000000/roles/111550000000000000" \
  -H "Authorization: Bot $BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"color":15158332}'

Örnek gövde

application/json

{
  "color": 15158332,
  "mentionable": true
}

Örnek yanıt

200 Başarılı

JSON

{
  "id": "111550000000000000",
  "name": "Örnek Bot",
  "color": 15158332,
  "hoist": false,
  "mentionable": true,
  "position": 1,
  "permissions": "68672",
  "auto_assign": false,
  "application_id": "111540000000000000"
}

Hatalar

Durum	Kodlar
400	validation_failed invalid_body everyone_role managed_role
401	unauthorized
403	missing_permissions role_hierarchy temporarily_banned
404	unknown_guild unknown_role
413	body_too_large
429	rate_limited
503	maintenance

Rolü sil

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

Çağıranın üstünde olduğu bir rolü siler. @everyone ve yönetilen roller silinemez.

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.
`role_id`zorunlu	string	Adreste Rol ID'si.

Örnek istek

curl -X DELETE "https://noluyo.net/api/v1/guilds/111500000000000000/roles/111550000000000000" \
  -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_role
429	rate_limited
503	maintenance