Публічне API

Розробка на Karmanet

Невелике вузькоспеціалізоване API: хто і коли лайкнув ваш Discord-сервер — щоб ви могли нагородити цих людей. І нічого більше.

Що вміє це API

Один ендпоінт: події лайків одного Discord-сервера, доступний лише його власнику. Не можна отримати список дизлайків, не можна отримати голоси за користувачів, і не можна побачити лайки сервера, яким ви не володієте — сам ключ прив'язаний рівно до одного сервера.

Автентифікація

Створіть ключ на сторінці свого сервера в Karmanet (видно лише власнику, поруч із відгуками). Передавайте його як bearer-токен у кожному запиті. Ключ показується один раз — при створенні або оновленні — збережіть його в надійному місці. При оновленні старий ключ одразу перестає працювати.

Authorization: Bearer kn_srv_xxxxxxxxxxxxxxxxxxxxxxxx

Ендпоінт

Повертає події лайків сервера, якому належить ключ, від нових до старих.

GET https://karmanet.app/api/public/v1/likes?limit=50&cursor=<opaque>

Параметри запиту:

  • limit — розмір сторінки, від 1 до 100, за замовчуванням 50.
  • cursor — непрозорий токен пагінації з nextCursor попередньої відповіді.

Відповідь:

{
  "items": [
    {
      "userId": "123456789012345678",
      "username": "alice",
      "avatarUrl": "https://cdn.discordapp.com/avatars/123.../abc.png",
      "likedAt": "2026-09-14T12:34:56.000Z"
    }
  ],
  "nextCursor": "eyJhbGciOiJub25lIn0"
}

Якщо nextCursor не null, передайте його назад як параметр cursor, щоб отримати наступну сторінку. Інструмент для розіграшу може просто періодично опитувати API без cursor і зупинятися, дійшовши до вже побачених лайків.

Обмеження частоти запитів

  • Кожен ключ — до 120 запитів на хвилину: достатньо для опитування раз на кілька секунд.
  • Кожна IP-адреса — до 60 запитів на хвилину, незалежно від валідності ключа.
  • При перевищенні ліміту відповідь 429 містить заголовок Retry-After у секундах.

Приватність і межі

Це API навмисно показує менше, ніж ви вже бачите як власник Discord-сервера — весь список учасників і так видно вам у самому Discord.

  • Тільки лайки сервера, якому належить ключ — ніколи не дизлайки і не голоси за користувачів.
  • Тільки Discord ID, поточні ім'я й аватар, і момент лайка.
  • Жодних IP-адрес, email і лайків, скасованих антирейд-захистом.
  • Ключ можна відкликати будь-якої миті на сторінці сервера — він одразу перестане працювати.
Є питання? Зв'яжіться з нами: [email protected] або DiscordНа головну