Публичное 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На главную