Mesajlar

Mesajları listele

Mesajları en yeniden eskiye döndürür: son sayfayı ya da bir mesajın öncesini, sonrasını veya çevresini. before ile after birlikte, around da bunlardan biriyle kullanılamaz. ReadMessageHistory yoksa yanıt hata değil, boş listedir. Çağıranın tepkileri reactions[].me ile işaretlenir. Sunucu kanalında, içerik intent'i olmayan bir bot başkalarının mesajlarını içeriği çıkarılmış olarak alır; botu etiketleyenler hariç.

Kimlik

Bot token'ı (bir kişinin oturumu da olur)

İzinler

ReadMessageHistory

Hız sınırı

read 30 istek / 5 sn

Parametreler

Örnek istek

curl "https://noluyo.net/api/v1/channels/111500000000000100/messages?limit=50" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

200 Başarılı

[
  {
    "id": "111600000000000000",
    "type": 0,
    "channel_id": "111500000000000100",
    "guild_id": "111500000000000000",
    "author": {
      "id": "111540000000000001",
      "username": "ornek_bot",
      "display_name": "Örnek Bot",
      "avatar": null,
      "cosmetics": null,
      "bot": true
    },
    "content": "Merhaba!",
    "timestamp": "2026-11-04T22:58:33.427Z",
    "edited_timestamp": null,
    "attachments": [],
    "mentions": [],
    "mention_roles": [],
    "mention_everyone": false,
    "pinned": false
  }
]

Hatalar

Mesaj gönder

Metin kanalına mesaj gönderir ve mesajla birlikte 200 döner. content en çok 2000 karakterdir; mesajda dosya, iletme, anket veya çıkartma yoksa zorunludur. Dosya göndermek için multipart/form-data kullan: JSON payload_json adlı parçada, en çok on dosya files[0], files[1] gibi adlandırılmış parçalarda olur; bunun için AttachFiles gerekir. message_reference mesajı yanıta çevirir (ReadMessageHistory); allowed_mentions.replied_user false, yanıtın kişiyi etiketlemesini önler. En çok 64 karakterlik nonce yalnızca bu yanıtta geri gelir. Bir mesajda anket, iletme ve çıkartmadan yalnızca biri olabilir; hiçbiri dosyayla birlikte gönderilemez. Sunucunun otomatik moderasyonu mesajı automod_blocked, kanalın yavaş modu slowmode ile reddedebilir. Botlar mesaja embed (en çok 10 kart) ve bileşen (buton ve menü, en çok 5 satır) ekleyebilir; nasıl yapıldığını embed rehberi anlatır. Embed görselleri mesajla gönderilen dosyalardır, başka bir adres olamaz. flags 64 (ephemeral) ephemeral_forbidden döner. Embed ve bileşenler ayrıca, boyutları sunucunun üye sayısıyla çarpılarak x-rate-limits içindeki fanout tavanına sayılır: X-RateLimit-Scope bot ile gelen 429 sahibinin payı ya da bekleme süresidir, shared ile gelen 429 tüm botların ortak tavanıdır ve botun suçu değildir; max_bytes ile gelen 400 fanout_too_large, mesajın o kanal için fazla büyük olduğunu söyler. Bir kişinin botunla açtığı DM'de kendiliğinden ancak kişinin son mesajı, komutu ya da basmasından sonraki 24 saat içinde yazabilirsin (dm_window_closed); kişi DM'yi kapattıysa ya da botu engellediyse hiç yazamazsın (dm_closed); tüm DM'lerinde toplam dm_send sınırı geçerlidir. Ayrıntılar özel mesajlar rehberinde.

Kimlik

Bot token'ı (bir kişinin oturumu da olur)

İzinler

SendMessagesAttachFilesReadMessageHistoryMentionEveryoneUseExternalStickersBirden çok izin varsa bazıları yalnızca belirli durumlarda gerekir; yukarıdaki açıklamaya bak.

Hız sınırı

message 5 istek / 5 sn

Parametreler

Gövde alanları

Örnek istek

curl -X POST "https://noluyo.net/api/v1/channels/111500000000000100/messages" \
  -H "Authorization: Bot $BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"content":"Merhaba!"}'

Örnek gövde

{
  "content": "Yeni sürüm yayında",
  "embeds": [
    {
      "title": "v1.4.0",
      "description": "Karanlık tema geldi.",
      "color": 3368703,
      "fields": [
        {
          "name": "Hata düzeltme",
          "value": "12",
          "inline": true
        }
      ]
    }
  ],
  "nonce": "istek-1"
}

Örnek yanıt

200 Başarılı

{
  "id": "111600000000000000",
  "type": 0,
  "channel_id": "111500000000000100",
  "guild_id": "111500000000000000",
  "author": {
    "id": "111540000000000001",
    "username": "ornek_bot",
    "display_name": "Örnek Bot",
    "avatar": null,
    "cosmetics": null,
    "bot": true
  },
  "content": "Merhaba!",
  "timestamp": "2026-11-04T22:58:33.427Z",
  "edited_timestamp": null,
  "attachments": [],
  "mentions": [],
  "mention_roles": [],
  "mention_everyone": false,
  "pinned": false,
  "nonce": "istek-1"
}

Hatalar

Mesajı getir

Tek bir mesajı döndürür. Listeden farklı olarak, ReadMessageHistory yoksa missing_permissions döner. Sunucu kanalında, içerik intent'i olmayan bir bot başkalarının mesajlarını içeriği çıkarılmış olarak alır; botu etiketleyenler hariç.

Kimlik

Bot token'ı (bir kişinin oturumu da olur)

İzinler

ReadMessageHistory

Hız sınırı

read 30 istek / 5 sn

Parametreler

Örnek istek

curl -X GET "https://noluyo.net/api/v1/channels/111500000000000100/messages/111600000000000000" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

200 Başarılı

{
  "id": "111600000000000000",
  "type": 0,
  "channel_id": "111500000000000100",
  "guild_id": "111500000000000000",
  "author": {
    "id": "111540000000000001",
    "username": "ornek_bot",
    "display_name": "Örnek Bot",
    "avatar": null,
    "cosmetics": null,
    "bot": true
  },
  "content": "Merhaba!",
  "timestamp": "2026-11-04T22:58:33.427Z",
  "edited_timestamp": null,
  "attachments": [],
  "mentions": [],
  "mention_roles": [],
  "mention_everyone": false,
  "pinned": false
}

Hatalar

Mesajı düzenle

Çağıranın kendi mesajını değiştirir. Kişi yalnızca content değiştirir. Bot content, embeds ve components alanlarını ayrı ayrı değiştirebilir: göndermediği alan kalır, boş liste embed veya bileşenleri kaldırır, yalnızca bileşen değişirse mesaj düzenlendi sayılmaz. Embed içindeki attachment:// yalnızca mesajın var olan dosyalarına bakar; yeni dosyalı istek reddedilir. Düzenleme, etiketlenenleri günceller ama kimseye yeniden bildirim göndermez. Dosya, iletme, anket, çıkartma veya embed içeren mesajın metni boşaltılabilir.

Kimlik

Bot token'ı (bir kişinin oturumu da olur)

İzinler

SendMessages

Hız sınırı

write 10 istek / 10 sn

Parametreler

Gövde alanları

Örnek istek

curl -X PATCH "https://noluyo.net/api/v1/channels/111500000000000100/messages/111600000000000000" \
  -H "Authorization: Bot $BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"content":"Merhaba, düzenlendi!"}'

Örnek gövde

{
  "content": "Merhaba, düzenlendi!"
}

Örnek yanıt

200 Başarılı

{
  "id": "111600000000000000",
  "type": 0,
  "channel_id": "111500000000000100",
  "guild_id": "111500000000000000",
  "author": {
    "id": "111540000000000001",
    "username": "ornek_bot",
    "display_name": "Örnek Bot",
    "avatar": null,
    "cosmetics": null,
    "bot": true
  },
  "content": "Merhaba, düzenlendi!",
  "timestamp": "2026-11-04T22:58:33.427Z",
  "edited_timestamp": "2026-11-05T09:00:00Z",
  "attachments": [],
  "mentions": [],
  "mention_roles": [],
  "mention_everyone": false,
  "pinned": false
}

Hatalar

Mesajı sil

Mesajı siler. Çağıranın kendi mesajı izin istemez; başkasının mesajı veya sunucudaki sistem mesajı ManageMessages ister.

Kimlik

Bot token'ı (bir kişinin oturumu da olur)

İzinler

ManageMessages

Hız sınırı

write 10 istek / 10 sn

Parametreler

Örnek istek

curl -X DELETE "https://noluyo.net/api/v1/channels/111500000000000100/messages/111600000000000000" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

204 Başarılı; yanıtın gövdesi yok.

Hatalar

Birden çok mesajı sil

Sunucudaki bir metin kanalının 2 ile 100 arası mesajını siler; hiçbiri 14 günden eski olamaz. Var olmayan mesajların ID'leri yok sayılır, tekrar edenler bir kez sayılır.

Kimlik

Bot token'ı (bir kişinin oturumu da olur)

İzinler

ManageMessages

Hız sınırı

bulk 1 istek / 1 sn

Parametreler

Gövde alanları

Örnek istek

curl -X POST "https://noluyo.net/api/v1/channels/111500000000000100/messages/bulk-delete" \
  -H "Authorization: Bot $BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"messages":["111600000000000000","111600000000000100"]}'

Örnek gövde

{
  "messages": [
    "111600000000000000",
    "111600000000000100"
  ]
}

Örnek yanıt

204 Başarılı; yanıtın gövdesi yok.

Hatalar