مستندات وب‌سرویس سرآور
ورود به داشبورد

مرجع api / commercial/persons/{nid}/career-history/

تاریخچه شغلی کامل

تمام سوابق شغلی شخص با لینک به اطلاعیه روزنامه رسمی.

GETcommercial/persons/{national_id}/career-history/

تاریخچه کامل مشاغل شرکتی شخص، شامل شرکت، نقش، تاریخ شروع و پایان، و در صورت موجود بودن شناسه اطلاعیه روزنامه رسمی منبع. برای تحلیل سابقه شغلی و اعتبارسنجی رزومه‌های مدیریتی مناسب است.

نیازمند اعتبار20 درخواست در دقیقه

هدرها

X-API-KEYstringبله

کلید api شما.

پارامترهای کوئری

national_idstringبله

شناسه ملی شخص.

idempotency_keystringبله

UUID یکتا.

نمونه درخواست

curl -X GET 'https://saravar.com/api/commercial/persons/1234567890/career-history/?idempotency_key=550e8400-e29b-41d4-a716-446655440000' \
  -H 'X-API-KEY: <YOUR_API_KEY>'

پاسخ

debit_transaction_idinteger | nullبله

شناسه تراکنش.

total_chargedintegerبله

مبلغ کسر شده بر حسب IRR.

dataCareerEntry[]بله

آرایه‌ای از { company_id_code, company_name, role_name, role_type, date_assigned, expire_date, is_current, legal_note_id_code }.

نکات قیمت‌گذاری و رفتار

  • هزینه به ازای هر ردیف تاریخچه بازگشتی محاسبه می‌شود.
  • فیلد legal_note_id_code به اطلاعیه روزنامه رسمی منبع لینک می‌دهد (در صورت موجود بودن).
  • حداقل کارمزد به ازای هر فراخوانی موفق اعمال می‌شود.

خطاها

400کد وضعیت
علتidempotency_key مفقود یا insufficient_credits.
اقدام پیشنهادیکلید معتبر ارسال کنید یا شارژ کنید.
401کد وضعیت
علتکلید api نامعتبر است.
اقدام پیشنهادیکلید فعال بسازید.
403کد وضعیت
علتاحراز هویت ملی تکمیل نشده.
اقدام پیشنهادیاحراز هویت را تکمیل کنید.
404کد وضعیت
علتشخص یافت نشد یا دارای حریم‌خصوصی فعال است.
اقدام پیشنهادیشناسه ملی را بررسی کنید.
429کد وضعیت
علتاز سقف نرخ عبور کرده‌اید.
اقدام پیشنهادیbackoff اعمال کنید.