مرجع api / commercial/companies/{nid}/full-profile/
بسته کامل شرکت
تمام دادههای شرکت در یک فراخوانی با ۲۰٪ تخفیف.
GET
commercial/companies/{national_id}/full-profile/تمام دادههای شرکت در یک فراخوانی: هویت، وضعیت فعال، نشانی، اعضای هیئتمدیره، صاحبان امضا، سهامداران، دستهها، اینمادها، مجوزها و نشانهای تجاری. همیشه ارزانتر از خرید جداگانه است (۲۰٪ تخفیف). در صورت نبود هر بخش، آن بخش از مجموع کسر میشود قبل از اعمال تخفیف.
نیازمند اعتبار20 درخواست در دقیقه
هدرها
X-API-KEYstringبلهکلید api شما.
پارامترهای کوئری
national_idstringبلهشناسه ملی شرکت.
idempotency_keystringبلهUUID یکتا.
نمونه درخواست
curl -X GET 'https://saravar.com/api/commercial/companies/12345678901/full-profile/?idempotency_key=550e8400-e29b-41d4-a716-446655440000' \-H 'X-API-KEY: <YOUR_API_KEY>'
پاسخ
debit_transaction_idinteger | nullبلهشناسه تراکنش.
total_chargedintegerبلهمبلغ کسر شده. برابر است با مجموع اجزای موجود × ۰٫۸.
data.identityobjectبلهاطلاعات هویتی شرکت.
data.active_statusobjectبلهوضعیت فعال بودن.
data.addressobject | nullبلهنشانی فعلی یا null.
data.board_membersarrayبلهاعضای هیئتمدیره فعال.
data.signatoriesarrayبلهصاحبان امضای فعال.
data.capital_sharesarrayبلهسهامداران فعلی.
data.categoriesarrayبلهدستهبندی صنعتی.
data.enamadsarrayبلهاینمادهای فعال.
data.licensesarrayبلهمجوزهای فعال.
data.trademarksarrayبلهنشانهای تجاری معتبر.
نکات قیمتگذاری و رفتار
- هزینه برابر است با مجموع اجزای موجود ضربدر ۰٫۸ (۲۰٪ تخفیف نسبت به خرید جداگانه).
- اجزای ناموجود (مثلاً اگر شرکت اینماد ندارد) از مجموع کسر میشوند پیش از اعمال تخفیف.
- حداقل کارمزد به ازای هر فراخوانی موفق اعمال میشود.
خطاها
400کد وضعیتعلتidempotency_key مفقود یا insufficient_credits.
اقدام پیشنهادیکلید معتبر ارسال کنید یا کیفپول را شارژ کنید.
401کد وضعیتعلتکلید api نامعتبر است.
اقدام پیشنهادیکلید فعال بسازید.
403کد وضعیتعلتاحراز هویت ملی تکمیل نشده.
اقدام پیشنهادیاحراز هویت را تکمیل کنید.
404کد وضعیتعلتشرکت یافت نشد.
اقدام پیشنهادیشناسه ملی را بررسی کنید.
429کد وضعیتعلتاز سقف نرخ عبور کردهاید.
اقدام پیشنهادیbackoff اعمال کنید.