API
Публичный read-only REST для интеграции данных chiprank.ru в твои проекты — справочные приложения, скрипты, дашборды, телеграм-боты.
API в стадии проектирования и появится в Phase 2. Текущий статус: эндпоинты определены, реализация пока отсутствует. Ниже — спецификация будущих маршрутов, чтобы было понятно к чему готовиться.
Хочешь раннего доступа — напиши на email (укажем после открытия) или подпишись на Telegram-канал (скоро). Дадим ключ из beta-cohort и попросим обратную связь.
Принципы
- Read-only. Никаких POST/PUT/DELETE — мы предоставляем данные, не принимаем
- JSON везде, UTF-8
- Бесплатно до 100 запросов/час с одного IP. Для большего — ключ
- Стабильные URL с версионированием через path:
/api/v1/... - CORS открыт для всех origin — можно дёргать прямо из браузера
- Кеширование через CF на 5 минут (Cache-Control)
- Rate-limit headers — `X-RateLimit-Remaining`, `X-RateLimit-Reset`
Планируемые эндпоинты
GET /api/v1/gpu Список GPU с фильтрами и сортировкой. Параметры: vendor, segment, vram_min, tdp_max, release_after, sort, limit, offset.
GET /api/v1/gpu?vendor=nvidia&vram_min=24&sort=perf_score&limit=10
→ { "items": [...], "total": 2955, "next_offset": 10 } GET /api/v1/gpu/{slug} Полные данные одной карты: характеристики, бенчмарки, 5 component-баллов, цены, редакционный обзор.
GET /api/v1/gpu/geforce-rtx-4090
→ { "slug": "geforce-rtx-4090", "name": "GeForce RTX 4090", ... } GET /api/v1/rating/{component} Рейтинг по выбранному component-баллу. Component: gaming | ai | render | compute | efficiency. Параметры: filter, vendor, vram, limit.
GET /api/v1/rating/ai?filter=consumer&vendor=nvidia&vram=24gb
→ { "rows": [{rank, slug, score, ...}] } GET /api/v1/compare/{a}-vs-{b} VS-сравнение двух GPU: дельты по 5 component-баллам и характеристикам.
GET /api/v1/compare/geforce-rtx-4090-vs-radeon-rx-7900-xtx
→ { "a": {...}, "b": {...}, "deltas": {gaming: +21.5, ai: ...} } GET /api/v1/prices/{slug} Текущие цены по GPU из всех источников. Топ-10 офферов отсортированы по цене.
GET /api/v1/prices/geforce-rtx-5090
→ { "min": 251120, "median": 309486, "offers": [...], "captured_at": "..." } GET /api/v1/collections Список сценарных подборок. Каждая — короткое описание + slugs топа.
GET /api/v1/collections
→ { "items": [{slug, title, items: ["slug1","slug2",...]}] } SDK
Тонкие официальные SDK планируются для Python и JavaScript/TypeScript. Будут на pypi и npm под именем chiprank. Open-source MIT.
Альтернатива сейчас
Пока API нет — можно скачать sitemap.xml и парсить статичные HTML-страницы. Все важные данные присутствуют в Schema.org JSON-LD блоках на каждой карточке (Product, BreadcrumbList, FAQPage). Это валидные структурированные данные, читаются стандартными schema.org-парсерами.