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