Public API v1
پلتفرم توسعهدهندگان AiDiscovery
داده ساختاریافته اکوسیستم هوش مصنوعی — مدلها، قیمتها، جستجو و منابع — بهصورت REST و JSON؛ همان دادهای که خود پلتفرم از آن استفاده میکند.
- OpenAPI 3.1
- Read-only
- Source-aware
https://api.aidiscovery.ir/api/v101
شروع سریع
کلید بسازید و اولین درخواست را در چند دقیقه بزنید.
احراز هویت
هدر X-Api-Key یا Authorization: Bearer — کلید فقط یکبار نمایش داده میشود.
برای دریافت کلید API، به پشتیبانی ایمیل بزنید: info@aidiscovery.ir
# اولین درخواست با کلید API:
curl -H "X-Api-Key: ak_live_YOUR_KEY" \
"https://api.aidiscovery.ir/api/v1/public/models?per_page=3"
نمونه درخواست
نمونههای واقعی از قرارداد فعلی.
curl -H "X-Api-Key: ak_live_YOUR_KEY" \
"https://api.aidiscovery.ir/api/v1/public/search?q=چت+جی+پی+تی&locale=fa"
{
"data": [
{
"id": "0192f3a1-…",
"slug": "gpt-4o",
"company": { "slug": "openai" },
"status": "released",
"context_window_tokens": 128000,
"updated_at": "2026-10-01T10:00:00+00:00"
}
],
"meta": { "current_page": 1, "per_page": 3, "total": 312, "last_page": 104 },
"links": { "first": "…", "last": "…", "next": "…", "prev": null }
}
02
گروههای endpoint
- GETModels — مدلهای زبانی و هوش مصنوعی
/public/models - GETCompanies — سازندگان اکوسیستم هوش مصنوعی
/public/companies - GETProducts — سرویسهای شرکتهای هوش مصنوعی
/public/products - GETTools — ابزارهای مبتنی بر هوش مصنوعی
/public/tools - GETPlans — پلنها
/public/plans - GETPricing — قیمتها
/public/pricing - GETSearch — جستوجو
/public/search - GETContent — محتوا
/public/articles
03
چرا API ایدیسکاوری؟
یک منبع حقیقت برای انسان و ماشین.
- 01
همان داده پلتفرم
API مستقیماً روی همان مدل داده کانونی وبسایت کار میکند — بدون نسخه دوم.
- 02
آگاه از منبع
هر پاسخ میتواند وضعیت راستیآزمایی و تازگی داده را نشان دهد (verified / stale / conflicting).
- 03
چندزبانه
fa / en / zh / ar با پارامتر locale — جستجوی چندزبانه با نامهای محلی.
- 04
سطحبندیشده
از Free تا Enterprise — سقفها دادهاند نه هاردکد.
- 05
ماشینخوان
JSON فشرده و قابل پیشبینی؛ مناسب agentها و نسل SDK آینده.
- 06
ETag / 304
درخواست شرطی روی endpointهای پایدار برای صرفهجویی پهنای باند.
04
سقفها و سطحها
نرخ/سهمیه هر سطح — از داده واقعی api_tiers.
| سطح | درخواست/دقیقه | سهمیه روزانه | سهمیه ماهانه | per_page |
|---|---|---|---|---|
| Free | ۳۰ | ۱٬۰۰۰ | ۲۵٬۰۰۰ | 25 |
| Developer | ۱۲۰ | ۲۰٬۰۰۰ | ۵۰۰٬۰۰۰ | 50 |
| Pro | ۳۰۰ | ۱۰۰٬۰۰۰ | ۲٬۰۰۰٬۰۰۰ | 100 |
| Business | ۶۰۰ | ∞ | ۱۰٬۰۰۰٬۰۰۰ | 100 |
| Enterprise | ۱٬۲۰۰ | ∞ | ∞ | 100 |
05
تغییرات API
افزودنها، تغییرات و deprecationها — بدون تغییر پنهان.
همین حالا بسازید
مرجع API و changelog را ببینید و همین حالا شروع به ساخت کنید.
برای دریافت کلید API، به پشتیبانی ایمیل بزنید: info@aidiscovery.ir