مرجع api / commercial/persons/{nid}/full-profile/
بسته کامل شخص
تمام داده‌های شخص در یک فراخوانی با ۲۰٪ تخفیف.
GET
commercial/persons/{national_id}/full-profile/تمام داده‌های شخص در یک فراخوانی: هویت، نقش‌های شرکتی، سهام‌ها، مجوزها، اینمادها و تاریخچه شغلی. ۲۰٪ تخفیف نسبت به خرید جداگانه. اجزای ناموجود از مجموع کسر می‌شوند قبل از اعمال تخفیف.
نیازمند اعتبار20 درخواست در دقیقه
هدرها
X-API-KEYstringبلهکلید api شما.
پارامترهای کوئری
national_idstringبلهشناسه ملی شخص.
idempotency_keystringبلهUUID یکتا.
نمونه درخواست
curl -X GET 'https://www.saravar.com/api/commercial/persons/1234567890/full-profile/?idempotency_key=550e8400-e29b-41d4-a716-446655440000' \-H 'X-API-KEY: <YOUR_API_KEY>'
پاسخ
debit_transaction_idinteger | nullبلهشناسه تراکنش.
total_chargedintegerبلهمبلغ کسر شده. برابر است با مجموع اجزای موجود × ۰٫۸.
data.identityobjectبلههویت شخص.
data.rolesarrayبلهنقشهای شرکتی گروه‌بندی‌شده.
data.sharesarrayبلهسهامداریها.
data.licensesarrayبلهمجوزها.
data.enamadsarrayبلهاینمادها.
data.career_historyarrayبلهتاریخچه کامل شغلی.
نکات قیمت‌گذاری و رفتار
- هزینه برابر است با مجموع اجزای موجود ضربدر ۰٫۸ (۲۰٪ تخفیف).
- اجزای ناموجود از مجموع کسر می‌شوند پیش از اعمال تخفیف.
- حداقل کارمزد به ازای هر فراخوانی موفق اعمال می‌شود.
خطاها
400کد وضعیتعلتidempotency_key مفقود یا insufficient_credits.
اقدام پیشنهادیکلید معتبر ارسال کنید یا شارژ کنید.
401کد وضعیتعلتکلید api نامعتبر است.
اقدام پیشنهادیکلید فعال بسازید.
403کد وضعیتعلتاحراز هویت ملی تکمیل نشده.
اقدام پیشنهادیاحراز هویت را تکمیل کنید.
404کد وضعیتعلتشخص یافت نشد یا دارای حریم‌خصوصی فعال است.
اقدام پیشنهادیشناسه ملی را بررسی کنید.
429کد وضعیتعلتاز سقف نرخ عبور کرده‌اید.
اقدام پیشنهادیbackoff اعمال کنید.