استفاده از API ها رایگان است؟
بله. تمام سرویسهای Nest API در حال حاضر کاملاً رایگان در اختیار توسعهدهندگان قرار دارند.
برای استفاده نیاز به توکن یا لایسنس هست؟
خیر. سرویسها عمومی هستند و بدون ثبتنام، توکن یا لایسنس جواب میدهند. کافی است آدرس سرویس را با پارامترهایش فراخوانی کنید.
آیا محدودیت درخواست وجود دارد؟
پلن یا سهمیهای تعریف نشده است، اما سرور برای محافظت از سرویس ممکن است در صورت ارسال بیش از حد درخواست، پاسخ 429 با کد RATE_LIMITED یا RATE_LIMIT_EXCEEDED برگرداند. بهتر است برنامهتان این حالت را مدیریت کند.
میتوانم مستقیم از مرورگر درخواست بفرستم؟
بله. CORS برای همهٔ دامنهها باز است و میتوانید از جاوااسکریپت سمت کلاینت هم سرویسها را صدا بزنید.
برای کدام زبانها SDK وجود دارد؟
پکیجهای رسمی PHP (با Composer)، Python (با pip) و JavaScript/TypeScript (با npm) منتشر شدهاند. هر زبان دیگری هم که بتواند درخواست HTTP بفرستد، مستقیم به API وصل میشود.
خطاها را چطور مدیریت کنم؟
همهٔ پاسخها فیلد success دارند. وقتی false باشد، شرط برنامه را روی error.code بگذارید و نه error.message، چون متن پیام ممکن است تغییر کند اما کد پایدار است.
نسخهٔ API چیست و کجا مشخص میشود؟
نسخه بخشی از آدرس است؛ برای مثال apis-1 در آدرس open.nestapi.ir/apis-1/bmi. هر سرویس نسخهٔ خودش را دارد و با اضافه شدن نسخه‌های جدید، نسخهٔ درست هر سرویس در فهرست سرویسها و صفحهٔ مستندات همان سرویس نوشته میشود.