# ساخت حساب و اعتبارنامه API
فراخوانی وبسرویسها به سه پیشنیاز وابسته است: حساب کاربری فعال، نام کاربری و رمز API، و اعتبار کافی.
# ساخت حساب کاربری
ورود و ثبتنام از طریق حساب یکپارچهی هیرادزرین انجام میشود. با شماره موبایل وارد پنل کاربری شوید و اطلاعات هویتی حساب را تکمیل کنید.
پس از ثبت شخص حقوقی، امکان جابهجایی بین حساب شخصی و حساب سازمانی وجود دارد. دسترسی هر کاربر به حساب سازمانی را مدیر آن حساب تعیین میکند.
# ساخت نام کاربری و رمز API
نام کاربری و رمز API یک جفت اعتبارنامهی مستقل برای فراخوانی وبسرویسها هستند و با نام کاربری و رمز ورود به پنل تفاوت دارند.
- وارد پنل کاربری شوید.
- به بخش تنظیمات حساب بروید.
- نام کاربری API را از همانجا بردارید و رمز API را تعریف یا بازنشانی کنید.
هر دو مقدار را در سرویس خود ذخیره کنید؛ username همان نام کاربری API است و شماره موبایل حساب نیست.
تغییر رمز API همهی refreshTokenهای صادرشده را بیاعتبار میکند و سرویسهای متصل باید دوباره توکن بگیرند. زمان تغییر رمز را با این نکته در نظر بگیرید.
# فعالسازی سرویسها
سرویسهای عمومی برای همهی حسابها در دسترساند. بخشی از سرویسها بهدلیل الزامات سامانهی مرجع خصوصی هستند و باید برای حساب فعال شوند؛ فعالسازی از طریق پشتیبانی انجام میشود.
فراخوانی سرویس فعالنشده با وضعیت ۴۰۳ و کد ۹ (Inaccessible) رد میشود.
# شارژ اعتبار
هزینهی هر فراخوانی موفق از اعتبار حساب کسر میشود. شارژ از پنل کاربری و از طریق درگاه پرداخت انجام میشود. جزئیات در اعتبار و تعرفه سرویسها.
# گام بعد
فراخوانی اولیه را ارسال کنید.