Sabitlenen mesajlar

Sabitlenen mesajlar için REST API rotaları.

Sabitlenen mesajları listele (`listPins`)

GET https://noluyo.net/api/v1/channels/{channel_id}/pins (GET /channels/{channel_id}/pins)

Sabitlenen mesajları, en son sabitlenenden başlayarak döndürür. limit 1 ile 50 arasındadır, varsayılanı 50'dir. Sayfalamak için has_more true olduğu sürece before'a son öğenin pinned_at değerini ver. ReadMessageHistory yoksa liste boştur. 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'ı (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.
`limit`	`query`	`integer`	-	Kaç sabitleme döneceği. (1–50 · = 50)
`before`	`query`	`datetime`	-	Bu zamandan önce yapılan sabitlemeler (RFC 3339).

Örnek çağrılar

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

// JavaScript (noluyo-bot)
await bot.rest.listPins("111500000000000100", { limit: 50 });

# Python (noluyo_bot)
await bot.rest.list_pins("111500000000000100", {"limit": 50})

Yanıt (200)

{
  "items": [
    {
      "pinned_at": "2026-11-05T09:00:00Z",
      "message": {
        "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": true
      }
    }
  ],
  "has_more": false
}

Hata kodları

HTTP 400: validation_failed, invalid_channel_type
HTTP 401: unauthorized
HTTP 403: missing_access, temporarily_banned
HTTP 404: unknown_channel
HTTP 429: rate_limited
HTTP 503: maintenance

Mesajı sabitle (`pinMessage`)

PUT https://noluyo.net/api/v1/channels/{channel_id}/pins/{message_id} (PUT /channels/{channel_id}/pins/{message_id})

Mesajı sabitler ve kanala bir sabitleme bildirimi (mesaj türü 6) gönderir. Zaten sabit olan mesajı sabitlemek bir şey değiştirmez. Bir kanalda en çok 250 sabit mesaj olur. Sistem mesajları sabitlenemez.

Kimlik: Bot token'ı (Authorization: Bot <BOT_TOKEN>)
İzinler: ManageMessages, ReadMessageHistory
Hız sınırı: write (10 / 10s)

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 PUT "https://noluyo.net/api/v1/channels/111500000000000100/pins/111600000000000000" \
  -H "Authorization: Bot $BOT_TOKEN"

// JavaScript (noluyo-bot)
await bot.rest.pinMessage("111500000000000100", "111600000000000000");

# Python (noluyo_bot)
await bot.rest.pin_message("111500000000000100", "111600000000000000")

Yanıt (204)

Yanıt gövdesi yok.

Hata kodları

HTTP 400: max_pins, invalid_channel_type
HTTP 401: unauthorized
HTTP 403: system_message, missing_access, missing_permissions, temporarily_banned, dm_closed, dm_window_closed
HTTP 404: unknown_channel, unknown_message
HTTP 429: rate_limited
HTTP 503: maintenance

Mesajın sabitlemesini kaldır (`unpinMessage`)

DELETE https://noluyo.net/api/v1/channels/{channel_id}/pins/{message_id} (DELETE /channels/{channel_id}/pins/{message_id})

Mesajın sabitlemesini kaldırır. Kanala bir şey gönderilmez.

Kimlik: Bot token'ı (Authorization: Bot <BOT_TOKEN>)
İzinler: ManageMessages, ReadMessageHistory
Hız sınırı: write (10 / 10s)

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/pins/111600000000000000" \
  -H "Authorization: Bot $BOT_TOKEN"

// JavaScript (noluyo-bot)
await bot.rest.unpinMessage("111500000000000100", "111600000000000000");

# Python (noluyo_bot)
await bot.rest.unpin_message("111500000000000100", "111600000000000000")

Yanıt (204)

Yanıt gövdesi yok.

Hata kodları

HTTP 400: invalid_channel_type
HTTP 401: unauthorized
HTTP 403: system_message, missing_access, missing_permissions, temporarily_banned, dm_closed, dm_window_closed
HTTP 404: unknown_channel, unknown_message
HTTP 429: rate_limited
HTTP 503: maintenance

Sabitlenen mesajlar