Результат: интеграция прочитает заявки, создаст одну тестовую заявку и безопасно повторит запрос без дубля.
Методы
| Метод | Назначение | Право API |
|---|---|---|
GET /applications |
Список и фильтры | applications:read |
GET /applications/{id} |
Одна заявка | applications:read |
POST /applications |
Создать | applications:write |
POST /applications/{application}/tags |
Синхронизировать теги | applications:write |
Чтение
curl --fail-with-body \
-H "Authorization: Bearer $APPSMAX_API_TOKEN" \
"https://telegram.appsmax.ru/api/v1/applications?bot_id=BOT_ID&page=1&per_page=20"Всегда обрабатывайте пагинацию. Не считайте первую страницу полным набором.
Создание без дубля
bot_id обязателен. Верхнеуровневый status не поддерживается: платформа назначает начальный статус. Для безопасного повтора используйте уникальный Idempotency-Key.
curl --fail-with-body -X POST \
-H "Authorization: Bearer $APPSMAX_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: test-unique-id" \
-d '{"bot_id":BOT_ID,"title":"[TEST] API"}' \
https://telegram.appsmax.ru/api/v1/applications
Проверка и ошибки
400/422— исправьте тело по OpenAPI.403— проверьте право API и принадлежность bot_id организации.404— объект не найден в доступной организации.409— конфликт состояния или idempotency; сначала прочитайте существующий результат.429— соблюдайте фактический rate limit изGET /me.
Очистка
Публичный API не обещает delete заявки. Удаляйте или архивируйте тестовый объект штатным доступным способом в кабинете, а тестовый идентификатор храните в журнале испытания.
Все схемы: технический справочник REST API.
Если не хочется разбираться самостоятельно, мы можем помочь. Поможем настроить платформу под вашу задачу и быстрее запустить проект без лишних шагов.