Kanallar
Kanalı getir
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'ı (bir kişinin oturumu da olur)
- Hız sınırı
- read 30 istek / 5 sn
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
channel_idzorunlu | string | Adreste Kanal ID'si. |
Örnek istek
curl -X GET "https://noluyo.net/api/v1/channels/111500000000000100" \
-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 | missing_accesstemporarily_banned |
| 404 | unknown_channel |
| 429 | rate_limited |
| 503 | maintenance |
Kanalı güncelle
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'ı (bir kişinin oturumu da olur)
- İzinler
- ManageChannels
- Hız sınırı
- write 10 istek / 10 sn
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
channel_idzorunlu | string | Adreste Kanal ID'si. |
Gövde alanları
| Ad | Tür | Açıklama |
|---|---|---|
name | string | 1–100 |
topic | string | null | ≤ 1024 |
position | integer | |
parent_id | ID | null | |
nsfw | boolean | |
bitrate | integer | 8000–96000 |
user_limit | integer | 0–99 |
rate_limit_per_user | integer | 0–21600 |
Örnek istek
curl -X PATCH "https://noluyo.net/api/v1/channels/111500000000000100" \
-H "Authorization: Bot $BOT_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"topic":"Hoş geldiniz"}'Örnek gövde
{
"topic": "Hoş geldiniz",
"rate_limit_per_user": 5
}Örnek yanıt
200 Başarılı
{
"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
}Hatalar
Kanalı sil
DELETE
/channels/{channel_id} Kanalı siler ve silinen kanalın nesnesiyle yanıt verir.
- 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 |
|---|---|---|
channel_idzorunlu | string | Adreste Kanal ID'si. |
Örnek istek
curl -X DELETE "https://noluyo.net/api/v1/channels/111500000000000100" \
-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 | missing_accessmissing_permissionstemporarily_banned |
| 404 | unknown_channel |
| 429 | rate_limited |
| 503 | maintenance |
Yazıyor göstergesini göster
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'ı (bir kişinin oturumu da olur)
- İzinler
- SendMessages
- Hız sınırı
- write 10 istek / 10 sn
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
channel_idzorunlu | string | Adreste Kanal ID'si. |
Örnek istek
curl -X POST "https://noluyo.net/api/v1/channels/111500000000000100/typing" \
-H "Authorization: Bot $BOT_TOKEN"Örnek yanıt
204 Başarılı; yanıtın gövdesi yok.