Sunucular
Sunucular; API'de sunucuya guild denir.
Sunucuyu getir (getGuild)
GET https://noluyo.net/api/v1/guilds/{guild_id} (GET /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'ı (
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. |
Örnek çağrılar
curl -X GET "https://noluyo.net/api/v1/guilds/111500000000000000" \
-H "Authorization: Bot $BOT_TOKEN"// JavaScript (noluyo-bot)
await bot.rest.getGuild("111500000000000000");# Python (noluyo_bot)
await bot.rest.get_guild("111500000000000000")Yanıt (200)
{
"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
}Hata kodları
- HTTP 401:
unauthorized - HTTP 403:
temporarily_banned - HTTP 404:
unknown_guild - HTTP 429:
rate_limited - HTTP 503:
maintenance
Sunucunun kanallarını listele (listGuildChannels)
GET https://noluyo.net/api/v1/guilds/{guild_id}/channels (GET /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'ı (
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. |
Örnek çağrılar
curl -X GET "https://noluyo.net/api/v1/guilds/111500000000000000/channels" \
-H "Authorization: Bot $BOT_TOKEN"// JavaScript (noluyo-bot)
await bot.rest.listGuildChannels("111500000000000000");# Python (noluyo_bot)
await bot.rest.list_guild_channels("111500000000000000")Yanıt (200)
[
{
"id": "111500000000000100",
"type": 0,
"guild_id": "111500000000000000",
"name": "genel",
"topic": null,
"position": 1,
"parent_id": null,
"nsfw": false,
"last_message_id": "111600000000000000",
"permission_overwrites": []
}
]Hata kodları
- HTTP 401:
unauthorized - HTTP 403:
temporarily_banned - HTTP 404:
unknown_guild - HTTP 429:
rate_limited - HTTP 503:
maintenance
Kanal oluştur (createChannel)
POST https://noluyo.net/api/v1/guilds/{guild_id}/channels (POST /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'ı (
Authorization: Bot <BOT_TOKEN>) - İzinler:
ManageChannels - Hız sınırı:
write(10 / 10s)
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama |
|---|---|---|---|---|
guild_id | path | string | evet | Sunucu ID'si. |
Gövde alanları
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | evet | (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 çağrılar
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}'// JavaScript (noluyo-bot)
await bot.rest.createChannel("111500000000000000", { name: "duyurular", type: 0 });# Python (noluyo_bot)
await bot.rest.create_channel("111500000000000000", {"name": "duyurular", "type": 0})Yanıt (201)
{
"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
}Hata kodları
- HTTP 400:
validation_failed,invalid_body,max_channels,max_overwrites - HTTP 401:
unauthorized - HTTP 403:
missing_permissions,temporarily_banned - HTTP 404:
unknown_guild - HTTP 413:
body_too_large - HTTP 429:
rate_limited - HTTP 503:
maintenance