Публічний API Vartovii v1

Ласкаво просимо до API Vartovii Intelligence. Використовуйте наш API для інтеграції показників Trust Scores, криптографічної експертизи (Crypto Forensics) та даних про репутацію роботодавців (Employer Reputation) безпосередньо у ваші програми.

Базовий URL

https://sentry-app-4p7rbtt5yq-oa.a.run.app/api/v1

Аутентифікація

Наразі API перебуває у стані Public Beta (публічного бета-тестування).

• Free Tier: API Key не потрібен. Обмежено 10 запитами на день на IP.
• Pro Tier: Потрібен API Key (незабаром). Необмежена кількість запитів.

Кінцеві точки

1. Перевірка стану служби

Перевірте доступність API та отримайте інформацію про кінцеві точки.

GET /api/v1/health

Відповідь:

{
  "status": "healthy",
  "api_version": "v1",
  "rate_limits": {
    "free_tier": "10 requests/day",
    "pro_tier": "Unlimited (coming soon)"
  },
  "endpoints": [
    "/api/v1/trust-score/{company}",
    "/api/v1/crypto/{slug}",
    "/api/v1/search"
  ]
}

---

2. Отримати Trust Score компанії

Отримайте агреговані дані про репутацію та Trust Score для будь-якої компанії.

GET /api/v1/trust-score/{company}

Параметри:

• company: Назва або slug компанії (наприклад, "google", "bmw", "microsoft")

Приклад запиту:

curl https://sentry-app-4p7rbtt5yq-oa.a.run.app/api/v1/trust-score/bmw

Відповідь:

{
  "company": "BMW",
  "trust_score": 37.1,
  "risk_level": "CRITICAL",
  "total_reviews": 5621,
  "avg_rating": 3.97,
  "last_updated": "2026-01-28T20:37:52.865897",
  "api_version": "v1"
}

Рівні ризику:

• LOW - Trust Score ≥ 70
• MEDIUM - Trust Score 50-69
• HIGH - Trust Score 40-49
• CRITICAL - Trust Score < 40

---

3. Аналіз криптопроєктів

Отримайте комплексний Trust Score та метрики для криптопроєктів.

GET /api/v1/crypto/{slug}

Параметри:

• slug: Символ токена або slug (наприклад, "bitcoin", "ethereum", "solana")

Приклад запиту:

curl https://sentry-app-4p7rbtt5yq-oa.a.run.app/api/v1/crypto/bitcoin

Відповідь:

{
  "name": "Bitcoin",
  "symbol": "BTC",
  "slug": "bitcoin",
  "trust_score": 87.0,
  "risk_level": "LOW",
  "price_usd": 89141.0,
  "market_cap": 1781914953851.0,
  "fdv": 1781916648348.0,
  "commits_last_30d": 500.0,
  "active_devs": 52.0,
  "last_updated": "2026-01-24T21:17:52.270273",
  "api_version": "v1"
}

---

4. Пошук

Уніфікований пошук серед компаній та криптопроєктів.

GET /api/v1/search?q={query}&type={type}

Параметри:

• q (обов'язковий): Пошуковий запит (мінімум 2 символи)
• type (необов'язковий): Фільтрувати за типом - all, crypto або company (за замовчуванням: all)

Приклад запиту:

# Пошук всіх сутностей
curl "https://sentry-app-4p7rbtt5yq-oa.a.run.app/api/v1/search?q=google"

# Пошук лише криптопроєктів
curl "https://sentry-app-4p7rbtt5yq-oa.a.run.app/api/v1/search?q=bit&type=crypto"

Відповідь:

{
  "query": "google",
  "count": 1,
  "results": [
    {
      "type": "company",
      "name": "Google",
      "trust_score": 76.5,
      "risk_level": "MEDIUM"
    }
  ],
  "api_version": "v1"
}

---

Обмеження запитів

Рівень	Ліміт	HTTP Header
Безкоштовний (Public Beta)	10 requests / day / IP	X-RateLimit-Limit: 10
Pro (незабаром)	Unlimited	API Key required

Заголовки обмеження запитів:

• X-RateLimit-Limit - Максимальна кількість дозволених запитів
• X-RateLimit-Remaining - Залишок запитів у поточному вікні
• X-RateLimit-Reset - Час скидання ліміту (Unix timestamp)

Відповідь про помилку (429):

{
  "error": "Rate limit exceeded",
  "message": "10 за 1 день"
}

---

Коди помилок

Код	Опис
200	Успіх
404	Сутність не знайдено
429	Ліміт запитів перевищено
500	Внутрішня помилка сервера

---

Підтримка

Для вищих лімітів запитів або доступу до Pro tier, зверніться:

• Email: support@sentryanalytic.com
• Документація: https://vartovii.cloud/docs

---

Останнє оновлення: January 28, 2026