Yasaklar
Yasakları listele
GET
/guilds/{guild_id}/bans Sunucunun yasaklarını nedenleriyle döndürür. Listede sayfalama yoktur.
- Kimlik
- Bot token'ı (bir kişinin oturumu da olur)
- İzinler
- BanMembers
- 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/bans" \
-H "Authorization: Bot $BOT_TOKEN"Örnek yanıt
200 Başarılı
[
{
"user": {
"id": "111400000000000000",
"username": "ayse",
"display_name": "Ayşe",
"avatar": null,
"cosmetics": null
},
"reason": "Spam"
}
]Hatalar
| Durum | Kodlar |
|---|---|
| 401 | unauthorized |
| 403 | missing_permissionstemporarily_banned |
| 404 | unknown_guild |
| 429 | rate_limited |
| 503 | maintenance |
Kullanıcıyı yasakla
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'ı (bir kişinin oturumu da olur)
- İzinler
- BanMembers
- Hız sınırı
- write 10 istek / 10 sn
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
guild_idzorunlu | string | Adreste Sunucu ID'si. |
user_idzorunlu | string | Adreste Kullanıcı ID'si. |
Gövde alanları
| Ad | Tür | Açıklama |
|---|---|---|
reason | string | null | ≤ 512 |
delete_message_seconds | integer | 0–604800 |
Örnek istek
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}'Örnek gövde
{
"reason": "Spam",
"delete_message_seconds": 3600
}Örnek yanıt
204 Başarılı; yanıtın gövdesi yok.
Hatalar
Yasağı kaldır
DELETE
/guilds/{guild_id}/bans/{user_id} Yasağı kaldırır. Yasaklı olmayan kullanıcı için unknown_ban döner.
- Kimlik
- Bot token'ı (bir kişinin oturumu da olur)
- İzinler
- BanMembers
- Hız sınırı
- write 10 istek / 10 sn
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
guild_idzorunlu | string | Adreste Sunucu ID'si. |
user_idzorunlu | string | Adreste Kullanıcı ID'si. |
Örnek istek
curl -X DELETE "https://noluyo.net/api/v1/guilds/111500000000000000/bans/111400000000000000" \
-H "Authorization: Bot $BOT_TOKEN"Örnek yanıt
204 Başarılı; yanıtın gövdesi yok.
Hatalar
| Durum | Kodlar |
|---|---|
| 401 | unauthorized |
| 403 | missing_permissionstemporarily_banned |
| 404 | unknown_banunknown_guild |
| 429 | rate_limited |
| 503 | maintenance |