N'oluyo · Geliştirici Dokümanları · Son güncelleme: · https://noluyo.net/gelistirici

Tepkiler

Tepkiler için REST API rotaları.

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

AdKonumTürZorunluAçıklama
channel_idpathstringevetKanal ID'si.
message_idpathstringevetMesaj ID'si.
emojipathstringevetURL 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

AdKonumTürZorunluAçıklama
channel_idpathstringevetKanal ID'si.
message_idpathstringevetMesaj ID'si.
emojipathstringevetURL kodlanmış Unicode emoji; ya da sunucu emojisi için ad:id, hareketliyse a:ad:id veya yalnızca ID.
user_idpathstringevetKullanı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

AdKonumTürZorunluAçıklama
channel_idpathstringevetKanal ID'si.
message_idpathstringevetMesaj ID'si.
emojipathstringevetURL kodlanmış Unicode emoji; ya da sunucu emojisi için ad:id, hareketliyse a:ad:id veya yalnızca ID.
limitqueryinteger-Kaç kullanıcı döneceği. (1–100 · = 25)
afterqueryID-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

AdKonumTürZorunluAçıklama
channel_idpathstringevetKanal ID'si.
message_idpathstringevetMesaj ID'si.
emojipathstringevetURL 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

AdKonumTürZorunluAçıklama
channel_idpathstringevetKanal ID'si.
message_idpathstringevetMesaj 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