مرجع api / commercial/persons/{nid}/licenses/
مجوزهای شخصی
مجوزهای کسب‌وکار که این شخص دارنده آن‌هاست.
GET
commercial/persons/{national_id}/licenses/مجوزهای فعال کسب‌وکار که این شخص دارنده آن‌هاست را برمی‌گرداند (پروانه‌های صنفی، مجوزهای تخصصی، ...).
نیازمند اعتبار20 درخواست در دقیقه
هدرها
X-API-KEYstringبلهکلید api شما.
پارامترهای کوئری
national_idstringبلهشناسه ملی شخص.
idempotency_keystringبلهUUID یکتا.
نمونه درخواست
curl -X GET 'https://www.saravar.com/api/commercial/persons/1234567890/licenses/?idempotency_key=550e8400-e29b-41d4-a716-446655440000' \-H 'X-API-KEY: <YOUR_API_KEY>'
پاسخ
debit_transaction_idinteger | nullبلهشناسه تراکنش.
total_chargedintegerبلهمبلغ کسر شده بر حسب IRR.
dataLicense[]بلهآرایه مجوزها، ساختار مشابه commercial/companies/.../licenses/.
نکات قیمت‌گذاری و رفتار
- هزینه به ازای هر مجوز بازگشتی محاسبه می‌شود — معادل قیمت همان endpoint در سمت شرکت.
- حداقل کارمزد به ازای هر فراخوانی موفق اعمال می‌شود.
خطاها
400کد وضعیتعلتidempotency_key مفقود یا insufficient_credits.
اقدام پیشنهادیکلید معتبر ارسال کنید یا شارژ کنید.
401کد وضعیتعلتکلید api نامعتبر است.
اقدام پیشنهادیکلید فعال بسازید.
403کد وضعیتعلتاحراز هویت ملی تکمیل نشده.
اقدام پیشنهادیاحراز هویت را تکمیل کنید.
404کد وضعیتعلتشخص یافت نشد یا دارای حریم‌خصوصی فعال است.
اقدام پیشنهادیشناسه ملی را بررسی کنید.
429کد وضعیتعلتاز سقف نرخ عبور کرده‌اید.
اقدام پیشنهادیbackoff اعمال کنید.