پرش به مطلب اصلی
همهٔ سرویس‌ها فعال و کاملاً رایگان

یک آدرس، ۵۴ سرویس آماده.

از مدل‌های هوش مصنوعی و دانلودرها تا جستجو و نرخ‌های لحظه‌ای؛ همه با یک ساختار JSON ثابت، بدون ثبت‌نام و بدون توکن.

  • رایگان
  • بدون توکن
  • CORS باز
GETopen.nestapi.ir/apis-1/bmi?age=30&weight=70&height=175
{
"success": true,
"data": {
"bmi": 22.86,
"status": "وزن نرمال (Normal)",
"risk": "🟢 وضعیت بدنی سالم و نرمال",
"input": {
"age": 30,
"weight": 70,
"height": 175
}
},
"source": {
"name": "NestAPI",
"version": "1.0.1"
}
}
پاسخ نمونه؛ برای درخواست واقعی «ارسال» را بزنید
وب‌سرویس آماده
۵۴
دستهٔ تخصصی
۶
تومان هزینه
۰
یک قرارداد پاسخ
JSON
استاندارد پاسخ

یک قرارداد برای همهٔ سرویس‌ها

  • همیشه یک ساختار

    موفق یا خطا، هر سرویس همان شکل پاسخ را برمی‌گرداند. یک بار کلاینت بنویسید و برای همه استفاده کنید.

  • کد خطای ماشین‌خوان

    error.code پایدار است و برای شرط‌نویسی ساخته شده؛ جزئیات هر پارامتر هم در details می‌آید.

  • آمادهٔ مرورگر و سرور

    CORS باز، HTTPS و خروجی UTF-8. از بک‌اند، اپلیکیشن یا مستقیم از مرورگر فراخوانی کنید.

جزئیات فرمت پاسخ
پاسخ موفق 200
{
"success": true,
"data": { "bmi": 22.86 },
"source": { "name": "NestAPI", "version": "1.0.1" }
}
پاسخ خطا 422
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Validation failed",
"details": { "query.age": "Must be less than or equal to 120" }
},
"source": { "name": "NestAPI", "version": "1.0.1" }
}
$ composer require nestapi/nestapi
use NestApi\NestApi;

$api = new NestApi();

$ip = $api->ipInfo(ip: '8.8.8.8');

echo $ip->get('location.country'); // United States
SDK رسمی

با پکیج رسمی، در چند خط وصل شوید

پکیج‌ها نام متد را به مسیر سرویس تبدیل می‌کنند؛ پس هر سرویس جدیدی بدون به‌روزرسانی پکیج در دسترس است.

  • PHPروی Packagist
  • Pythonروی PyPI
  • JavaScriptروی npm
مشاهدهٔ پکیج‌ها
سوالات

سوالات پرتکرار

پاسخ سوال‌هایی که معمولاً قبل از شروع پیش می‌آید.

استفاده از API ها رایگان است؟

بله. تمام سرویس‌های Nest API در حال حاضر کاملاً رایگان در اختیار توسعه‌دهندگان قرار دارند.

برای استفاده نیاز به توکن یا لایسنس هست؟

خیر. سرویس‌ها عمومی هستند و بدون ثبت‌نام، توکن یا لایسنس جواب می‌دهند. کافی است آدرس سرویس را با پارامترهایش فراخوانی کنید.

آیا محدودیت درخواست وجود دارد؟

پلن یا سهمیه‌ای تعریف نشده است، اما سرور برای محافظت از سرویس ممکن است در صورت ارسال بیش از حد درخواست، پاسخ 429 با کد RATE_LIMITED یا RATE_LIMIT_EXCEEDED برگرداند. بهتر است برنامه‌تان این حالت را مدیریت کند.

می‌توانم مستقیم از مرورگر درخواست بفرستم؟

بله. CORS برای همهٔ دامنه‌ها باز است و می‌توانید از جاوااسکریپت سمت کلاینت هم سرویس‌ها را صدا بزنید.

همهٔ سوالات

اولین درخواست‌تان را همین حالا بفرستید.

نه فرم ثبت‌نامی هست و نه کلیدی که منتظرش بمانید. یک سرویس را انتخاب کنید و نتیجه را ببینید.