API документация

Мы добавили API-ключи для доступа к публичному API и интеграции данных с внешними системами.

Как найти эту функцию :

1. Зайдите в дэшборд автора в мини-аппе Tribute.

2. Нажмите на иконку с тремя точками в правом верхнем углу и выберите «Настройки».

3. Откройте раздел «Управление API-ключами».

Как работают вебхуки:

На определенные события мы отправляем пользователю запрос с телом ивента.

Сейчас есть два вебхука:

1. NewSubscriptionEvent - покупка подписки

2. CancelledSubscriptionEvent - отмена подписки

Хука на продление подписки нет.

Проверка подписи запроса

1. Возьмите тело запроса в том виде, в котором оно было получено.

2. Подпишите его своим API-ключом тем же методом.

3. Сравните полученную подпись с заголовком trbt-signature.

Если подписи совпадают — запрос подлинный.

Response examples:

{ created_at: "2025-03-20T01:15:58.33246Z", name: "new_subscription", payload: { subscription_name: "Поддержите творчество 🌟", subscription_id: 1644, period_id: 1547, period: "monthly", price: 1000, amount: 700, currency: "eur", user_id: 31326, telegram_user_id: 12321321, channel_id: 614, channel_name: "lbs", expires_at: "2025-04-20T01:15:57.305733Z", }, sent_at: "2025-03-20T01:15:58.542279448Z", }

{ created_at: "2025-03-21T11:20:44.013969Z", name: "cancelled_subscription", payload: { subscription_name: "Присоединяйтесь к закрытому клубу 🎉", subscription_id: 1646, period_id: 1549, period: "monthly", price: 1000, amount: 1000, currency: "eur", user_id: 31326, telegram_user_id: 12321321, channel_id: 614, channel_name: "lbs", cancel_reason: "", expires_at: "2025-03-20T11:13:44.737Z", }, sent_at: "2025-03-21T11:20:44.527657077Z", }

NewSubscriptionEvent
SubscriptionName	string	subscription_name
SubscriptionID	uint	subscription_id
PeriodID	uint	period_id
Period	string	period
Price	int64	price
Amount	int64	amount
Currency	string	currency
UserID	uint	user_id
TelegramUserID	uint	telegram_user_id
ChannelID	uint	channel_id
ChannelName	string	channel_name
ExpiresAt	time	expires_at
CancelledSubscriptionEvent
SubscriptionName	string	subscription_name
SubscriptionID	uint	subscription_id
PeriodID	uint	period_id
Period	string	period
Price	int64	price
Amount	int64	amount
Currency	string	currency
UserID	uint	user_id
TelegramUserID	uint	telegram_user_id
ChannelID	uint	channel_id
ChannelName	string	channel_name
CancelReason	string	cancel_reason
ExpiresAt	time	expires_at