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