Bank hisoboti (PDF hujjat, ularni ishlab chiqarish uzoq davom etadi) uchun API ni loyihalashtiring. Qaysi endpointlar kerak?

Bank hisobotini yaratish API uchun, PDF yaratish uzoq vaqt olishi mumkinligini hisobga olib, bir nechta endpointlar bilan asinxron yondashuvni tavsiya etamiz:

1. POST /statements/generate

   • Yangi hisobot yaratish uchun so'rov.
   • So'rovning tanasida davr, hisob, filtrlash va boshqalar parametrlar yuboriladi.
   • Unikal statementId va "jarayon" holati bilan javob beradi.

2. GET /statements/{statementId}/status

   • Hisobot yaratish holatini tekshirish.
   • Holat: "jarayon" yoki "tayyor" yoki "xato".

3. GET /statements/{statementId}/download

   • Tayyor PDF-ni yuklab olish.
   • Holat "tayyor" bo'lsa, faylni qaytaradi.

4. DELETE /statements/{statementId} (ixtiyoriy)

   • Bo'sh joyni bo'shatish uchun yaratilgan hisobotni o'chirish.

Bu yondashuv mijozga yaratish tugashini kutmasdan, holatni tekshirish va fayl tayyor bo'lsa, uni yuklab olish imkonini beradi.