Uzun sürede oluşturulan banka ekstresi (PDF belge) oluşturmak için bir API tasarla. Hangi uç noktalar gerekli?

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

1. POST /statements/generate

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

2. GET /statements/{statementId}/status

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

3. GET /statements/{statementId}/download

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

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

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

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