Введение
Базовый URL: https://api.cashbox.money/v1. Все ответы — JSON. Аутентификация — Bearer-токен.
Аутентификация
Получите API-ключ в личном кабинете → Настройки → Сервисы → API. Передавайте его в заголовке Authorization: Bearer <token>.
Задачи
- POST /tasks — создать задачу
- GET /tasks — список задач
- GET /tasks/{id} — получить задачу
- PATCH /tasks/{id} — обновить
- DELETE /tasks/{id} — архивировать
Отчёты
- GET /reports — список отчётов
- GET /reports/{id} — детали
- POST /reports/{id}/accept — принять
- POST /reports/{id}/reject — отклонить
Вебхуки
Подпишитесь на события в Настройках → Сервисы → Вебхуки. Подпись — HMAC-SHA256.
- task.created
- task.completed
- report.submitted
- report.accepted
- report.rejected
- balance.low
Лимиты
1000 запросов в минуту на ключ. При превышении возвращается 429 Too Many Requests.
Коды ошибок
200 OK · 201 Created · 400 Bad Request · 401 Unauthorized · 403 Forbidden · 404 Not Found · 409 Conflict · 429 Too Many · 5xx Server.
SDK и примеры
Готовые SDK: JavaScript/TypeScript, Python, PHP, Go. Примеры — в репозитории github.com/cashbox-money.