API для выдачи спонсорских карточек в Telegram-боте

1. 1

   1. Проверка

   POST /integrations/{projectId}/ping — убедиться, что ключ относится к активному проекту.

2. 2

   2. Получение

   POST /integrations/{projectId}/next с recipientId и limit от 1 до 10.

3. 3

   3. Отправка

   Отправить полученную карточку через Telegram без изменения защищённых URL.

4. 4

   4. Подтверждение

   После подтверждённой отправки вызвать endpoint, который соответствует productType.

const response = await fetch(
  'https://evir.bot/api/v1/integrations/PROJECT_ID/next',
  {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.EVIR_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ recipientId: String(user.id), limit: 3 }),
  },
);
const { data } = await response.json();

Не вызывайте /served, если Telegram доказанно отклонил отправку. При timeout с неизвестным результатом не пересылайте карточку автоматически.