سرویس «استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست» در دسته استعلام قبض فینوتک، نوع قبض و شناسه مربوط به آن را میگیرد و یک شناسه درخواست همراه وضعیت اولیه استعلام برمیگرداند. این مرحله نتیجه قبض را نمیدهد؛ نتیجه در مرحله دوم، دریافت نتیجه، با همان شناسه درخواست خوانده میشود.
در استعلام همگام، درخواست کاربر تا رسیدن پاسخ منتظر میماند؛ اگر پاسخ دیر برسد، صفحه قفل میشود، تایماوت سمت شما رخ میدهد و کاربر دوباره دکمه را میزند. در استعلام گروهی — مثل بهروزرسانی بدهی فهرستی از مشترکان یا مکانها — این الگو بدتر هم میشود، چون یک درخواست کند، کل صف پردازش شما را نگه میدارد.
استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست چیست؟
سرویسی است که اطلاعات قبض را دریافت میکند و در پاسخ، شناسه درخواست و وضعیت فعلی استعلام را برمیگرداند تا نتیجه در مرحله بعد با همان شناسه خوانده شود.
تفاوت این سرویس با مرحله دوم چیست؟
این مرحله درخواست را ثبت و شناسه آن را صادر میکند؛ اطلاعات قبض در مرحله ۲ — دریافت نتیجه برگردانده میشود.
چه زمانی بهتر است از مسیر ناهمگام استفاده کنم؟
وقتی نمیخواهید درخواست کاربر منتظر پردازش بماند یا حجم استعلامها زیاد است و کارها را در صف پسزمینه اجرا میکنید؛ برای یک استعلام تکمرحلهای، استعلام قبض سادهتر است.
آیا این سرویس قبض را پرداخت میکند؟
خیر. کل این دسته فقط استعلام است و پرداخت قبض در آن انجام نمیشود.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.