Sunucular
Sunucular; API'de sunucuya guild denir.
Sunucuyu getir
/guilds/{guild_id} Sunucuyu tüm rolleriyle döndürür. Üye olmayan çağıran unknown_guild alır; böylece sunucunun var olup olmadığı açığa çıkmaz.
- 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_idzorunlu | string | Adreste Sunucu ID'si. |
Örnek istek
curl -X GET "https://noluyo.net/api/v1/guilds/111500000000000000" \
-H "Authorization: Bot $BOT_TOKEN"Örnek yanıt
200 Başarılı
{
"id": "111500000000000000",
"name": "Örnek Sunucu",
"icon": null,
"banner": null,
"description": null,
"owner_id": "111400000000000500",
"created_at": "2026-11-04T16:21:11.569Z",
"features": [],
"roles": [
{
"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"
}
],
"discoverable": false,
"discovery_category": null,
"join_channel_id": null,
"leave_channel_id": null
}Hatalar
| Durum | Kodlar |
|---|---|
| 401 | unauthorized |
| 403 | temporarily_banned |
| 404 | unknown_guild |
| 429 | rate_limited |
| 503 | maintenance |
Sunucunun kanallarını listele
/guilds/{guild_id}/channels Çağıranın ViewChannel iznine sahip olduğu kanal ve kategorileri döndürür. Diğerleri hata vermeden listeden çıkarılı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_idzorunlu | string | Adreste Sunucu ID'si. |
Örnek istek
curl -X GET "https://noluyo.net/api/v1/guilds/111500000000000000/channels" \
-H "Authorization: Bot $BOT_TOKEN"Örnek yanıt
200 Başarılı
[
{
"id": "111500000000000100",
"type": 0,
"guild_id": "111500000000000000",
"name": "genel",
"topic": null,
"position": 1,
"parent_id": null,
"nsfw": false,
"last_message_id": "111600000000000000",
"permission_overwrites": []
}
]Hatalar
| Durum | Kodlar |
|---|---|
| 401 | unauthorized |
| 403 | temporarily_banned |
| 404 | unknown_guild |
| 429 | rate_limited |
| 503 | maintenance |
Kanal oluştur
/guilds/{guild_id}/channels Metin kanalı (tür 0, varsayılan), ses kanalı (2) veya kategori (4) oluşturur. topic ve rate_limit_per_user metin kanalları, bitrate ve user_limit ses kanalları içindir. permission_overwrites verilmezse kategoriye konan kanal kategorinin izin geçersiz kılmalarıyla başlar. Bir geçersiz kılma, yalnızca çağıranın sahip olduğu izinlere dokunabilir.
- Kimlik
- Bot token'ı (bir kişinin oturumu da olur)
- İzinler
- ManageChannels
- Hız sınırı
- write 10 istek / 10 sn
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
guild_idzorunlu | string | Adreste Sunucu ID'si. |
Gövde alanları
| Ad | Tür | Açıklama |
|---|---|---|
namezorunlu | string | 1–100 |
type | integer | 0, 2, 4 · = 0 |
topic | string | null | ≤ 1024 |
position | integer | |
parent_id | ID | 64 bitlik ID; yanıtta da istekte de her zaman metin olarak yazılır. ID'ler oluşturulma zamanına göre sıralanır. |
nsfw | boolean | |
bitrate | integer | 8000–96000 · = 64000 |
user_limit | integer | 0–99 · = 0 |
rate_limit_per_user | integer | 0–21600 |
permission_overwrites | Overwrite[] | ≤ 100 |
Örnek istek
curl -X POST "https://noluyo.net/api/v1/guilds/111500000000000000/channels" \
-H "Authorization: Bot $BOT_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"name":"duyurular","type":0}'Örnek gövde
{
"name": "duyurular",
"type": 0,
"topic": "Önemli haberler",
"rate_limit_per_user": 30
}Örnek yanıt
201 Başarılı
{
"id": "111500000000000100",
"type": 0,
"guild_id": "111500000000000000",
"name": "duyurular",
"topic": "Önemli haberler",
"position": 1,
"parent_id": null,
"nsfw": false,
"last_message_id": null,
"permission_overwrites": [],
"rate_limit_per_user": 30
}