Результат: интеграция создаст проверяемый черновик; запуск останется отдельным осознанным действием.
Методы
| Метод | Что делает |
|---|---|
GET /campaigns |
Список |
GET /campaigns/{campaign} |
Одна кампания |
POST /campaigns |
Создаёт черновик или запланированную запись |
POST /campaigns/{id}/run |
Отдельно запускает или планирует |
Чтение требует campaigns:read, создание и запуск — campaigns:write.
Безопасный порядок
- Сначала создайте только тестовую аудиторию.
- Проверьте согласие, назначение, канал и содержание.
- Создайте черновик по схеме OpenAPI.
- Прочитайте его через GET и проверьте статус.
- Не вызывайте run в автоматическом тесте.
- Для реального запуска введите отдельное подтверждение оператора.
curl --fail-with-body \
-H "Authorization: Bearer $APPSMAX_API_TOKEN" \
"https://telegram.appsmax.ru/api/v1/campaigns?page=1&per_page=20&sort=created_at"
Что означает успех API
2xx подтверждает принятие операции платформы, но не гарантирует доставку конкретному человеку. Доставка зависит от аудитории, согласия, канала, подключения и правил внешней платформы.
Ошибки и отмена
403— нет campaigns:write.409— состояние уже изменилось; сначала перечитайте кампанию.422— поля не соответствуют контракту.429— остановите цикл и примените ограничение скорости.
Незапущенный тестовый черновик удалите либо архивируйте штатным способом кабинета. Не вызывайте undocumented DELETE.
Нужна помощь с запуском?
Если не хочется разбираться самостоятельно, мы можем помочь. Поможем настроить платформу под вашу задачу и быстрее запустить проект без лишних шагов.