Kanallar

Kanallar için REST API rotaları.

Kanalı getir (getChannel)

GET https://noluyo.net/api/v1/channels/{channel_id} (GET /channels/{channel_id})

Çağıranın görebildiği bir kanalı döndürür. ViewChannel izni olmayan üye missing_access, sunucunun dışındaki biri unknown_channel alır.

• Kimlik: Bot token'ı (Authorization: Bot <BOT_TOKEN>)
• Hız sınırı: read (30 / 5s)

Parametreler

Örnek çağrılar

curl -X GET "https://noluyo.net/api/v1/channels/111500000000000100" \
  -H "Authorization: Bot $BOT_TOKEN"

// JavaScript (noluyo-bot)
await bot.rest.getChannel("111500000000000100");

# Python (noluyo_bot)
await bot.rest.get_channel("111500000000000100")

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: missing_access, temporarily_banned
• HTTP 404: unknown_channel
• HTTP 429: rate_limited
• HTTP 503: maintenance

Kanalı güncelle (updateChannel)

PATCH https://noluyo.net/api/v1/channels/{channel_id} (PATCH /channels/{channel_id})

Yalnızca gönderilen alanları değiştirir. topic ve rate_limit_per_user metin, bitrate ve user_limit ses kanalları içindir; parent_id aynı sunucudaki bir kategori olmalıdır, null kanalı kategorisinden çıkarır, kategorinin üst kategorisi olamaz.

• Kimlik: Bot token'ı (Authorization: Bot <BOT_TOKEN>)
• İzinler: ManageChannels
• Hız sınırı: write (10 / 10s)

Parametreler

Gövde alanları

Örnek çağrılar

curl -X PATCH "https://noluyo.net/api/v1/channels/111500000000000100" \
  -H "Authorization: Bot $BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"topic":"Hoş geldiniz"}'

// JavaScript (noluyo-bot)
await bot.rest.updateChannel("111500000000000100", { topic: "Hoş geldiniz" });

# Python (noluyo_bot)
await bot.rest.update_channel("111500000000000100", {"topic": "Hoş geldiniz"})

Yanıt (200)

{
  "id": "111500000000000100",
  "type": 0,
  "guild_id": "111500000000000000",
  "name": "genel",
  "topic": "Hoş geldiniz",
  "position": 1,
  "parent_id": null,
  "nsfw": false,
  "last_message_id": "111600000000000000",
  "permission_overwrites": [],
  "rate_limit_per_user": 5
}

Hata kodları

• HTTP 400: validation_failed, invalid_body
• HTTP 401: unauthorized
• HTTP 403: missing_access, missing_permissions, temporarily_banned
• HTTP 404: unknown_channel
• HTTP 413: body_too_large
• HTTP 429: rate_limited
• HTTP 503: maintenance

Kanalı sil (deleteChannel)

DELETE https://noluyo.net/api/v1/channels/{channel_id} (DELETE /channels/{channel_id})

Kanalı siler ve silinen kanalın nesnesiyle yanıt verir.

• Kimlik: Bot token'ı (Authorization: Bot <BOT_TOKEN>)
• İzinler: ManageChannels
• Hız sınırı: write (10 / 10s)

Parametreler

Örnek çağrılar

curl -X DELETE "https://noluyo.net/api/v1/channels/111500000000000100" \
  -H "Authorization: Bot $BOT_TOKEN"

// JavaScript (noluyo-bot)
await bot.rest.deleteChannel("111500000000000100");

# Python (noluyo_bot)
await bot.rest.delete_channel("111500000000000100")

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: missing_access, missing_permissions, temporarily_banned
• HTTP 404: unknown_channel
• HTTP 429: rate_limited
• HTTP 503: maintenance

Yazıyor göstergesini göster (sendTyping)

POST https://noluyo.net/api/v1/channels/{channel_id}/typing (POST /channels/{channel_id}/typing)

Kanaldaki kişilere botun yazdığını gösterir. Yalnızca metin kanallarında çalışır. İstek gövdesi yoktur.

• Kimlik: Bot token'ı (Authorization: Bot <BOT_TOKEN>)
• İzinler: SendMessages
• Hız sınırı: write (10 / 10s)

Parametreler

Örnek çağrılar

curl -X POST "https://noluyo.net/api/v1/channels/111500000000000100/typing" \
  -H "Authorization: Bot $BOT_TOKEN"

// JavaScript (noluyo-bot)
await bot.rest.sendTyping("111500000000000100");

# Python (noluyo_bot)
await bot.rest.send_typing("111500000000000100")

Yanıt (204)

Yanıt gövdesi yok.

Hata kodları

• HTTP 400: invalid_channel_type
• HTTP 401: unauthorized
• HTTP 403: missing_access, missing_permissions, temporarily_banned, dm_closed, dm_window_closed
• HTTP 404: unknown_channel
• HTTP 429: rate_limited
• HTTP 503: maintenance