Банк анықтамасын (PDF құжат) жасау үшін API-ді жобалаңыз. Қандай эндпоинттер қажет?

Для API генерации банковской выписки, учитывая, что генерация PDF может занимать длительное время, рекомендуется использовать асинхронный подход с несколькими эндпоинтами:

1. POST /statements/generate

   • Запрос на создание новой выписки.
   • В теле запроса передаются параметры: период, счет, фильтры и т.п.
   • Возвращает уникальный statementId и статус "в обработке".

2. GET /statements/{statementId}/status

   • Проверка статуса генерации выписки.
   • Возвращает статус: "в обработке", "готово", "ошибка".

3. GET /statements/{statementId}/download

   • Скачивание готового PDF.
   • Возвращает файл, если статус "готово".

4. DELETE /statements/{statementId} (опционально)

   • Удаление сгенерированной выписки для освобождения места.

Такой подход позволяет клиенту не ждать завершения генерации, а опрашивать статус и скачивать файл, когда он будет готов.