Документация APIAPI documentation
Задания для подписчиков и Показы в вашем боте — MGRAM платит вам за каждое выполнение и каждый показ. Обычные HTTPS‑запросы с JSON — без SDK.Tasks for subscribers and Reply Ads in your bot — MGRAM pays you for every completion and every impression. Plain HTTPS requests with JSON — no SDK.
curl -X POST https://api.mgram.biz/tasks \
-H "Authorization: Bearer YOUR_BOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"user_id": 123456789}'{"ok": true, "data": {
"skip": false,
"tasks": [{"id": 3773, "button_text": "Подписаться",
"link": "https://t.me/+AbCdEfGh",
"reward": "0.77", "status": "pending"}]
}}curl -X POST https://api.mgram.biz/reply-ads/show \
-H "Authorization: Bearer YOUR_BOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"user_id": 123456789, "message_id": 5521}'{"ok": true, "data": {
"shown": true,
"delivery_id": 812345,
"message_id": 4521
}}Для фабрик ботовFor bot factories Partner API
Регистрируйте ботов своих клиентов и управляйте ими через API.Register your clients’ bots and manage them through the API.
POST /register/botрегистрацияregistrationGET /register/botsсписок и статусыlist and statuseswebhookрешение модерацииmoderation decision
Partner ID — это Telegram ID вашего аккаунта. Отправьте его в поддержку — мы выдадим Partner API key.Partner ID is your account Telegram ID. Send it to support — we will issue a Partner API key.
Задания для подписчиковTasks for subscribers
Задания для пользователей вашего бота — MGRAM платит вам за каждое выполнение.Tasks for your bot users — MGRAM pays you for every completion.
https://api.mgram.bizAuthorization: Bearer KEY- Получите заданияGet tasks
POST /tasks— покажите кнопкамиshow as buttons - Узнайте о выполненииLearn it is donewebhookwebhook
task.completedилиorPOST /tasks/check - Пустите дальшеLet them through
skip: true— всё выполненоall done
ПоказыReply Ads
Реклама в момент, который выбрали вы. MGRAM отправляет её от имени вашего бота; оплата за показ — как в обычных Показах.An ad at the moment you choose. MGRAM sends it from your bot; paid per impression as usual Reply Ads.
https://api.mgram.bizAuthorization: Bearer KEY- Включите ПоказыTurn Reply Ads onв настройках бота в MGRAMin the bot settings in MGRAM
- Вызовите в нужный моментCall at the right moment
POST /reply-ads/show— после полезного действия пользователяafter a useful action of the user - Проверьте ответCheck the answer
shown: true— реклама уже отправлена вашим ботом; иначе продолжайте как обычноthe ad is already sent by your bot; otherwise go on as usual
Webhook-иWebhooks
События на ваш сервер: пользователь выполнил задание или отписался; решение модерации бота фабрики.Events to your server: the user completed a task or left; the moderation decision for a factory bot.
X-MGRAM-Signaturetimestamp + "." + bodyAPI для фабрик ботовAPI for bot factories
Подключение ботов клиентов и управление ими.Connect your clients’ bots and manage them.
https://api.mgram.bizAuthorization: Bearer KEYПубличный HTTPS URL. Ответьте 200 или 204. Подпись: HMAC-SHA256 от timestamp + "." + тело, заголовок X-MGRAM-Signature.A public HTTPS URL. Answer 200 or 204. Signature: HMAC-SHA256 of timestamp + "." + body, header X-MGRAM-Signature.
Нужен корректный публичный HTTPS URL.Enter a valid public HTTPS URL.
СправочникReference
Все методы API с параметрами и ответами. Найдите метод по пути или названию.Every API method with parameters and responses. Find a method by path or name.
Примеры кодаCode examples
Выберите метод и язык — получите готовый код и пример ответа.Pick a method and a language — get ready code and a sample response.
Тестовые ID и токены замените своими значениями. API key храните только на сервере.Replace sample IDs and tokens with your own values. Keep API keys server-side only.
ОшибкиErrors
Все ошибки приходят в одном формате. Найдите HTTP-код — рядом написано, что исправить.All errors share one format. Find the HTTP status — what to fix is next to it.
Формат ответаResponse format
{
"ok": false,
"error": {
"code": "validation_error",
"message": "..."
}
}