مرجع api / commercial/companies/{nid}/signatories/
صاحبان امضای فعال
فهرست مدیرعامل و دارندگان حق امضای فعلی شرکت.
GET
commercial/companies/{national_id}/signatories/فهرست صاحبان امضای فعال شرکت (مدیرعامل و دارندگان حق امضا) را برمیگرداند. فقط نقشهای فعال (تاریخ پایان منقضی نشده) شامل میشوند. اشخاص دارای حریمخصوصی فعال در پاسخ حذف میشوند و هزینهای برای آنها محاسبه نمیشود.
نیازمند اعتبار20 درخواست در دقیقه
هدرها
X-API-KEYstringبلهکلید api شما.
پارامترهای کوئری
national_idstringبلهشناسه ملی شرکت (۱۱ رقم). path parameter.
idempotency_keystringبلهUUID یکتا برای جلوگیری از پرداخت دوگانه.
نمونه درخواست
curl -X GET 'https://saravar.com/api/commercial/companies/12345678901/signatories/?idempotency_key=550e8400-e29b-41d4-a716-446655440000' \-H 'X-API-KEY: <YOUR_API_KEY>'
پاسخ
debit_transaction_idinteger | nullبلهشناسه تراکنش کسر اعتبار.
total_chargedintegerبلهمبلغ کسر شده بر حسب IRR.
dataSignatory[]بلهآرایهای از { person: { id_code, full_name, national_id, masked_national_id }, role_name, role_type, date_assigned, expire_date }.
نکات قیمتگذاری و رفتار
- هزینه به ازای هر رکورد بازگشتی محاسبه میشود. اگر شخصی به دلیل حریمخصوصی حذف شود، نه نمایش داده میشود و نه هزینهبر است.
- حداقل کارمزد به ازای هر فراخوانی موفق اعمال میشود.
خطاها
400کد وضعیتعلتidempotency_key مفقود است یا insufficient_credits.
اقدام پیشنهادیکلید idempotency معتبر ارسال کنید یا کیفپول را شارژ کنید.
401کد وضعیتعلتکلید api نامعتبر است.
اقدام پیشنهادیکلید فعال بسازید.
403کد وضعیتعلتکاربر دارنده کلید احراز هویت ملی را تکمیل نکرده است.
اقدام پیشنهادیاحراز هویت را تکمیل کنید.
404کد وضعیتعلتشرکتی با این شناسه ملی یافت نشد.
اقدام پیشنهادیصحت شناسه ملی را بررسی کنید.
429کد وضعیتعلتاز سقف نرخ عبور کردهاید.
اقدام پیشنهادیبا backoff تلاش کنید.