مرجع api / commercial/persons/role-check/
اعتبارسنجی نقش
بررسی نقش شخص در یک شرکت — معادل companies/role-check/.
POST
commercial/persons/role-check/معادل companies/role-check/: اعتبارسنجی این که آیا شخصی هم‌اکنون نقش مشخصی را در یک شرکت دارد. بدنه، پاسخ و هزینه دقیقاً مشابه نسخه company-centric است؛ برای حفظ ساختار URL در یکپارچه‌سازی‌های person-centric ارائه شده.
نیازمند اعتبار20 درخواست در دقیقه
هدرها
X-API-KEYstringبلهکلید api شما.
Content-Typestringبلهdefault:
application/jsonباید application/json باشد.
بدنه درخواست
company_national_idstringبلهشناسه ملی شرکت (۱۱ رقم).
person_national_idstringبلهشناسه ملی شخص (۱۰ رقم).
role_typestringیکی از مقادیر مجاز نقش (ceo، board_member، …). در صورت عدم ارسال، وجود هر نقش فعال بررسی می‌شود.
idempotency_keystringبلهUUID یکتا.
نمونه درخواست
curl -X POST 'https://www.saravar.com/api/commercial/persons/role-check/' \-H 'X-API-KEY: <YOUR_API_KEY>' \-H 'Content-Type: application/json' \-d '{"company_national_id": "12345678901","person_national_id": "1234567890","role_type": "ceo","idempotency_key": "550e8400-e29b-41d4-a716-446655440000"}'
پاسخ
debit_transaction_idinteger | nullبلهشناسه تراکنش.
total_chargedintegerبلهمبلغ کسر شده بر حسب IRR.
data.is_validbooleanبلهآیا نقش معتبر است.
data.role_typestring | nullبلهنوع نقش تأیید شده.
data.role_namestring | nullبلهنام فارسی نقش.
data.date_assignedstring | nullبلهتاریخ شروع.
data.expire_datestring | nullبلهتاریخ پایان (در صورت وجود).
نکات قیمت‌گذاری و رفتار
- یک واحد به ازای هر فراخوانی موفق محاسبه می‌شود — صرف‌نظر از is_valid.
- این endpoint دقیقاً معادل commercial/companies/role-check/ است.
- حداقل کارمزد به ازای هر فراخوانی موفق اعمال می‌شود.
خطاها
400کد وضعیتعلتپارامتر اجباری مفقود، role_type نامعتبر، یا insufficient_credits.
اقدام پیشنهادیبدنه را بررسی کنید و در صورت نیاز شارژ کنید.
401کد وضعیتعلتکلید api نامعتبر است.
اقدام پیشنهادیکلید فعال بسازید.
403کد وضعیتعلتاحراز هویت ملی تکمیل نشده.
اقدام پیشنهادیاحراز هویت را تکمیل کنید.
404کد وضعیتعلتشرکت یا شخص یافت نشد.
اقدام پیشنهادیشناسه‌های ملی را بررسی کنید.
429کد وضعیتعلتاز سقف نرخ عبور کرده‌اید.
اقدام پیشنهادیbackoff اعمال کنید.