Yasaklar

Yasaklar için REST API rotaları.

Yasakları listele (listBans)

GET https://noluyo.net/api/v1/guilds/{guild_id}/bans (GET /guilds/{guild_id}/bans)

Sunucunun yasaklarını nedenleriyle döndürür. Listede sayfalama yoktur.

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

Parametreler

Örnek çağrılar

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

// JavaScript (noluyo-bot)
await bot.rest.listBans("111500000000000000");

# Python (noluyo_bot)
await bot.rest.list_bans("111500000000000000")

Yanıt (200)

[
  {
    "user": {
      "id": "111400000000000000",
      "username": "ayse",
      "display_name": "Ayşe",
      "avatar": null,
      "cosmetics": null
    },
    "reason": "Spam"
  }
]

Hata kodları

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

Kullanıcıyı yasakla (createBan)

PUT https://noluyo.net/api/v1/guilds/{guild_id}/bans/{user_id} (PUT /guilds/{guild_id}/bans/{user_id})

Kullanıcıyı yasaklar, üyeyse sunucudan çıkarır; üye, çağıranın altında olmalıdır. Üye olmayan biri önceden yasaklanabilir. Gövde isteğe bağlıdır. delete_message_seconds, kişinin o kadar saniye öncesine kadarki mesajlarını da siler; en fazla 604800 (yedi gün). reason en çok 512 karakterdir.

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

Parametreler

Gövde alanları

Örnek çağrılar

curl -X PUT "https://noluyo.net/api/v1/guilds/111500000000000000/bans/111400000000000000" \
  -H "Authorization: Bot $BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"reason":"Spam","delete_message_seconds":3600}'

// JavaScript (noluyo-bot)
await bot.rest.createBan("111500000000000000", "111400000000000000", { reason: "Spam", delete_message_seconds: 3600 });

# Python (noluyo_bot)
await bot.rest.create_ban("111500000000000000", "111400000000000000", {"reason": "Spam", "delete_message_seconds": 3600})

Yanıt (204)

Yanıt gövdesi yok.

Hata kodları

• HTTP 400: validation_failed, invalid_body, cannot_target_self
• HTTP 401: unauthorized
• HTTP 403: missing_permissions, role_hierarchy, temporarily_banned
• HTTP 404: unknown_guild, unknown_user
• HTTP 413: body_too_large
• HTTP 429: rate_limited
• HTTP 503: maintenance

Yasağı kaldır (deleteBan)

DELETE https://noluyo.net/api/v1/guilds/{guild_id}/bans/{user_id} (DELETE /guilds/{guild_id}/bans/{user_id})

Yasağı kaldırır. Yasaklı olmayan kullanıcı için unknown_ban döner.

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

Parametreler

Örnek çağrılar

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

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

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

Yanıt (204)

Yanıt gövdesi yok.

Hata kodları

• HTTP 401: unauthorized
• HTTP 403: missing_permissions, temporarily_banned
• HTTP 404: unknown_ban, unknown_guild
• HTTP 429: rate_limited
• HTTP 503: maintenance