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