ID пользователя
USER_ID
Личный SECRET
SECRET
Настройка API endpoint
Шаг 1
Настройка API в боте
- REACTOR CODE BOT
- Профиль
- API
Шаг 2
API-доступ и список команд
После перехода в раздел API бот показывает персональный ID, личный SECRET и точки доступа, через которые пользователь будет работать с API.
В каждом запросе нужен user_id и SECRET
Эти значения пользователь берет из API-раздела. Без них запросы к точкам доступа не выполняются.
12 запросов в минуту
Лимит действует на все команды API. Если запросов больше, нужно дождаться следующей минуты.
Список команд, который пользователь видит в боте:
Platforms: GET https://reactor.atomparser.io/api/v1/platforms
Screen: POST https://reactor.atomparser.io/api/v1/screen
QR: POST https://reactor.atomparser.io/api/v1/qr
Шаг 3
Команды API и примеры запросов
Ниже три основные команды. Сначала пользователь получает список площадок, затем отправляет данные для генерации QR-Screen или отдельного Smart QR.
Список площадок
Возвращает список площадок, цены и схему полей, которые нужны для команд screen и qr.
Генерация QR-Screen
Создает скриншот с QR-кодом. Подходит, когда нужен готовый экран для оплаты.
Генерация Smart QR
Создает только QR-код без QR-Screen изображения. Используется, когда нужен сам QR.
Получить список площадок:
curl -G "https://reactor.atomparser.io/api/v1/platforms" \
--data-urlencode "user_id=USER_ID" \
--data-urlencode "secret=SECRET"Сгенерировать QR-Screen:
curl -X POST "https://reactor.atomparser.io/api/v1/screen" \
-H "Content-Type: application/json" \
-d '{
"user_id": "USER_ID",
"secret": "SECRET",
"platform": "vinted",
"qr_url": "https://example.com/pay",
"qr_mode": "pro",
"country": "de",
"system": "IOS",
"title": "Nike Air Max 90",
"price": "45.00 EUR",
"seller_name": "Anna_M"
}' \
--output screen.jpgСгенерировать Smart QR:
curl -X POST "https://reactor.atomparser.io/api/v1/qr" \
-H "Content-Type: application/json" \
-d '{
"user_id": "USER_ID",
"secret": "SECRET",
"qr_url": "https://example.com/pay",
"qr_mode": "smart"
}' \
--output qr.jpg
Справочник
Коды ошибок
Ниже основные ответы API, которые пользователь может получить при ошибке запроса.
401
Нет user_id / secret
{"ok": false, "error": "secret required"}
403
Неверный ключ, нет доступа
{"ok": false, "error": "invalid secret"}
402
Недостаточно средств
{"ok": false, "error": "...", "required": 0.3, "balance": 0.1}
422
Ошибка валидации полей
{"ok": false, "error": "...", "field": "country"}
429
Превышен лимит
{"ok": false, "error": "rate limit exceeded", "retry_after": 42}
500
Ошибка генерации
{"ok": false, "error": "Generation failed"}