Tepkiler
Tepkiler için REST API rotaları.
Mesaja tepki ver (addReaction)
PUT https://noluyo.net/api/v1/channels/{channel_id}/messages/{message_id}/reactions/{emoji}/@me (PUT /channels/{channel_id}/messages/{message_id}/reactions/{emoji}/@me)
Botun tepkisini ekler. Mesajda olmayan bir emoji AddReactions ister; zaten olan emojiye katılmak istemez, ama bot susturulmuşsa buna da izin verilmez. Bir mesajda en çok 20 farklı emoji olur. İki kez tepki vermek bir şey değiştirmez.
- Kimlik: Bot token'ı (
Authorization: Bot <BOT_TOKEN>) - İzinler:
ReadMessageHistory,AddReactions - Hız sınırı:
reaction(4 / 1s)
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama |
|---|---|---|---|---|
channel_id | path | string | evet | Kanal ID'si. |
message_id | path | string | evet | Mesaj ID'si. |
emoji | path | string | evet | URL kodlanmış Unicode emoji; ya da sunucu emojisi için ad:id, hareketliyse a:ad:id veya yalnızca ID. |
Örnek çağrılar
curl -X PUT "https://noluyo.net/api/v1/channels/111500000000000100/messages/111600000000000000/reactions/%F0%9F%91%8B/@me" \
-H "Authorization: Bot $BOT_TOKEN"
// JavaScript (noluyo-bot)
await bot.rest.addReaction("111500000000000100", "111600000000000000", "👋");
# Python (noluyo_bot)
await bot.rest.add_reaction("111500000000000100", "111600000000000000", "👋")
Yanıt (204)
Yanıt gövdesi yok.
Hata kodları
- HTTP 400:
unknown_emoji,too_many_reactions,invalid_channel_type - HTTP 401:
unauthorized - HTTP 403:
missing_access,missing_permissions,temporarily_banned,dm_closed,dm_window_closed - HTTP 404:
unknown_channel,unknown_message - HTTP 429:
rate_limited - HTTP 503:
maintenance
Tepkiyi kaldır (removeReaction)
DELETE https://noluyo.net/api/v1/channels/{channel_id}/messages/{message_id}/reactions/{emoji}/{user_id} (DELETE /channels/{channel_id}/messages/{message_id}/reactions/{emoji}/{user_id})
Bir kişinin tepkisini kaldırır. Botun kendi tepkisi için user_id @me olabilir; başkasınınki ManageMessages ister.
- Kimlik: Bot token'ı (
Authorization: Bot <BOT_TOKEN>) - İzinler:
ReadMessageHistory,ManageMessages - Hız sınırı:
reaction(4 / 1s)
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama |
|---|---|---|---|---|
channel_id | path | string | evet | Kanal ID'si. |
message_id | path | string | evet | Mesaj ID'si. |
emoji | path | string | evet | URL kodlanmış Unicode emoji; ya da sunucu emojisi için ad:id, hareketliyse a:ad:id veya yalnızca ID. |
user_id | path | string | evet | Kullanıcı ID'si ya da botun kendisi için @me. |
Örnek çağrılar
curl -X DELETE "https://noluyo.net/api/v1/channels/111500000000000100/messages/111600000000000000/reactions/%F0%9F%91%8B/@me" \
-H "Authorization: Bot $BOT_TOKEN"
// JavaScript (noluyo-bot)
await bot.rest.removeReaction("111500000000000100", "111600000000000000", "👋", "@me");
# Python (noluyo_bot)
await bot.rest.remove_reaction("111500000000000100", "111600000000000000", "👋", "@me")
Yanıt (204)
Yanıt gövdesi yok.
Hata kodları
- HTTP 400:
unknown_emoji,invalid_channel_type - HTTP 401:
unauthorized - HTTP 403:
missing_access,missing_permissions,temporarily_banned - HTTP 404:
unknown_channel,unknown_message,unknown_user - HTTP 429:
rate_limited - HTTP 503:
maintenance
Tepki verenleri listele (listReactors)
GET https://noluyo.net/api/v1/channels/{channel_id}/messages/{message_id}/reactions/{emoji} (GET /channels/{channel_id}/messages/{message_id}/reactions/{emoji})
Bir emojiyle tepki veren kullanıcıları döndürür. limit 1 ile 100 arasındadır, varsayılanı 25'tir; sayfalamak için after'a bir kullanıcı ID'si ver.
- Kimlik: Bot token'ı (
Authorization: Bot <BOT_TOKEN>) - İzinler:
ReadMessageHistory - Hız sınırı:
read(30 / 5s)
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama |
|---|---|---|---|---|
channel_id | path | string | evet | Kanal ID'si. |
message_id | path | string | evet | Mesaj ID'si. |
emoji | path | string | evet | URL kodlanmış Unicode emoji; ya da sunucu emojisi için ad:id, hareketliyse a:ad:id veya yalnızca ID. |
limit | query | integer | - | Kaç kullanıcı döneceği. (1–100 · = 25) |
after | query | ID | - | Bu kullanıcı ID'sinden sonrasını getirir. |
Örnek çağrılar
curl "https://noluyo.net/api/v1/channels/111500000000000100/messages/111600000000000000/reactions/%F0%9F%91%8B?limit=25" \
-H "Authorization: Bot $BOT_TOKEN"
// JavaScript (noluyo-bot)
await bot.rest.listReactors("111500000000000100", "111600000000000000", "👋", { limit: 25 });
# Python (noluyo_bot)
await bot.rest.list_reactors("111500000000000100", "111600000000000000", "👋", {"limit": 25})
Yanıt (200)
[
{
"id": "111400000000000000",
"username": "ayse",
"display_name": "Ayşe",
"avatar": null,
"cosmetics": null
}
]
Hata kodları
- HTTP 400:
unknown_emoji,validation_failed,invalid_channel_type - HTTP 401:
unauthorized - HTTP 403:
missing_access,missing_permissions,temporarily_banned - HTTP 404:
unknown_channel,unknown_message - HTTP 429:
rate_limited - HTTP 503:
maintenance
Bir emojinin tepkilerini kaldır (clearEmojiReactions)
DELETE https://noluyo.net/api/v1/channels/{channel_id}/messages/{message_id}/reactions/{emoji} (DELETE /channels/{channel_id}/messages/{message_id}/reactions/{emoji})
Mesajdan bu emojiyle verilmiş tüm tepkileri kaldırır.
- Kimlik: Bot token'ı (
Authorization: Bot <BOT_TOKEN>) - İzinler:
ManageMessages - Hız sınırı:
reaction(4 / 1s)
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama |
|---|---|---|---|---|
channel_id | path | string | evet | Kanal ID'si. |
message_id | path | string | evet | Mesaj ID'si. |
emoji | path | string | evet | URL kodlanmış Unicode emoji; ya da sunucu emojisi için ad:id, hareketliyse a:ad:id veya yalnızca ID. |
Örnek çağrılar
curl -X DELETE "https://noluyo.net/api/v1/channels/111500000000000100/messages/111600000000000000/reactions/%F0%9F%91%8B" \
-H "Authorization: Bot $BOT_TOKEN"
// JavaScript (noluyo-bot)
await bot.rest.clearEmojiReactions("111500000000000100", "111600000000000000", "👋");
# Python (noluyo_bot)
await bot.rest.clear_emoji_reactions("111500000000000100", "111600000000000000", "👋")
Yanıt (204)
Yanıt gövdesi yok.
Hata kodları
- HTTP 400:
unknown_emoji,invalid_channel_type - HTTP 401:
unauthorized - HTTP 403:
missing_access,missing_permissions,temporarily_banned - HTTP 404:
unknown_channel,unknown_message - HTTP 429:
rate_limited - HTTP 503:
maintenance
Tüm tepkileri kaldır (clearReactions)
DELETE https://noluyo.net/api/v1/channels/{channel_id}/messages/{message_id}/reactions (DELETE /channels/{channel_id}/messages/{message_id}/reactions)
Mesajdaki tüm tepkileri kaldırır.
- Kimlik: Bot token'ı (
Authorization: Bot <BOT_TOKEN>) - İzinler:
ManageMessages - Hız sınırı:
reaction(4 / 1s)
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama |
|---|---|---|---|---|
channel_id | path | string | evet | Kanal ID'si. |
message_id | path | string | evet | Mesaj ID'si. |
Örnek çağrılar
curl -X DELETE "https://noluyo.net/api/v1/channels/111500000000000100/messages/111600000000000000/reactions" \
-H "Authorization: Bot $BOT_TOKEN"
// JavaScript (noluyo-bot)
await bot.rest.clearReactions("111500000000000100", "111600000000000000");
# Python (noluyo_bot)
await bot.rest.clear_reactions("111500000000000100", "111600000000000000")
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 - HTTP 404:
unknown_channel,unknown_message - HTTP 429:
rate_limited - HTTP 503:
maintenance