scores.technicalامتیاز فنی از ۱۰۰؛ ۶۰٪ زمان پاسخ و ۴۰٪ امنیت، بر اساس قواعد ثابت پلتفرم
Public API · v1.0
دادههای معتبر تجربه هاست را به سایت، نرمافزار یا ابزار هوش مصنوعی خود متصل کنید
API عمومی و فقطخواندنی تجربه هاست، رتبهبندی 22 شرکت را همراه با زمان پاسخ، پایداری، امنیت فنی، نتایج پایش و دیدگاههای تأییدشده در قالب JSON پایدار ارائه میکند. دادهها با معیارهای ثابت پلتفرم و تحلیل چندسامانهای هوش مصنوعی آماده میشوند تا برای مقایسه حرفهای میزبانها و ساخت ابزارهای تصمیمیار قابل استفاده باشند.
یک endpoint کامل برای رتبهبندی هوشمند و فیلتر دادهها
GET
https://tajrobehost.ir/api/v1/hosting-rankingsخروجی پیشفرض، شرکتها را بر اساس تازهترین امتیاز فنی مرتب میکند. هر پاسخ شامل زمان تولید، روش محاسبه، دامنه داده، اطلاعات پایش و شیوه صحیح انتساب منبع است تا توسعهدهنده بتواند رتبهها را با زمینه کامل نمایش دهد.
دادههای API از پایشهای دورهای تجربه هاست و آزمونهای فنی ثبتشده به دست میآیند. امتیاز فنی با یک فرمول ثابت محاسبه میشود؛ ۶۰٪ آن به زمان پاسخ واقعی و ۴۰٪ به وضعیت امنیت اختصاص دارد. دادههای هر پایش برای افزایش دقت توسط OpenAI، Google Gemini، xAI Grok و Anthropic Claude بررسی و مقایسه میشوند و هیچ امتیاز دستی، تبلیغاتی یا پولی در جایگاه شرکتها دخالت ندارد.
پارامترهای Query
| پارامتر | نوع | مقادیر | توضیح |
|---|---|---|---|
id | integer | شناسه شرکت | دریافت یک شرکت مشخص |
q | string | حداکثر ۱۰۰ نویسه | جستوجو در نام و دستهبندی |
status | enum | all, online, offline | فیلتر وضعیت آخرین پایش |
sort | enum | technical_score, response_ms, uptime_percent, security_score, review_count, name | معیار مرتبسازی |
order | enum | asc, desc | جهت مرتبسازی |
limit | integer | ۱ تا ۱۰۰ | تعداد نتیجه؛ پیشفرض ۲۲ |
offset | integer | صفر یا بیشتر | شروع صفحهبندی |
مثال: دریافت ۵ میزبان آنلاین با سریعترین پاسخ
/api/v1/hosting-rankings?status=online&sort=response_ms&order=asc&limit=5فیلدهای مهم پاسخ
availability.uptime_percentدرصد پایداری ثبتشده در ۲۵ پایش اخیر
timings_ms.totalزمان کل پاسخ ثبتشده در آخرین پایش به میلیثانیه
timings_ms.ttfbزمان دریافت نخستین بایت در آخرین سنجش فنی
scores.securityامتیاز امنیت بر پایه کنترلهای فنی آخرین ممیزی
last_checked_atزمان ثبت تازهترین پایش معتبر
مقادیر اندازهگیرینشده با null بازگردانده میشوند تا داده ناقص با امتیاز صفر اشتباه نشود. تعریف کامل فیلدها و قرارداد پایدار پاسخ در فایل OpenAPI در دسترس است.
نمونه استفاده در زبانهای مختلف
const response = await fetch('https://tajrobehost.ir/api/v1/hosting-rankings?limit=5');
const payload = await response.json();
payload.data.forEach(company => console.log(company.rank, company.name));$json = file_get_contents('https://tajrobehost.ir/api/v1/hosting-rankings?limit=5');
$payload = json_decode($json, true);
foreach ($payload['data'] as $company) echo $company['name'] . PHP_EOL;import requests
response = requests.get("https://tajrobehost.ir/api/v1/hosting-rankings", params={"limit": 5}, timeout=15)
for company in response.json()["data"]: print(company["rank"], company["name"])curl "https://tajrobehost.ir/api/v1/hosting-rankings?limit=5"خروجی واقعی API را همینجا مشاهده کنید
{}داده آماده برای ابزارها و عاملهای هوش مصنوعی
llms.txtراهنمای تفسیر، استناد و استفاده صحیح از داده
OpenAPI 3.1قرارداد استاندارد و قابلخواندن برای ابزارها
- زمان آخرین پایش و معیارهای امتیازدهی را همراه نتیجه نمایش دهید تا پیشنهاد همواره به داده معتبر متصل باشد.
- رتبه را بهعنوان نتیجه زنده و دادهمحور تجربه هاست معرفی کنید که با پایشهای جدید بهروزرسانی میشود.
- مقدار
nullرا نبود داده کافی در نظر بگیرید، نه امتیاز صفر یا نتیجه منفی. - برای حفظ شفافیت، منبع را با نام «تجربه هاست» و لینک مستندات API ذکر کنید.
قواعد استفاده، کش و اعتبار دادهها
انتساب منبع
کنار رتبه یا داده نمایشدادهشده عبارت «منبع: تجربه هاست» را همراه با لینک این مستندات قرار دهید تا منشأ ارزیابی برای کاربر شفاف باشد.
کش پیشنهادی
برای دریافت سریع و پایدار دادهها، پاسخ را حداقل ۳۰ ثانیه کش کنید و بهجای درخواستهای تکراری از آخرین پاسخ معتبر استفاده کنید.
دامنه اعتبار داده
دادههای تجربه هاست برای مقایسه فنی، شناسایی میزبانهای باکیفیت و ساخت پیشنهادهای دقیق طراحی شدهاند. هر نتیجه بر اساس آخرین پایش معتبر ارائه میشود و با ثبت دادههای جدید بهروزرسانی خواهد شد.