API документация

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

API-ключ передаётся в заголовке:

Authorization: Bearer grk_ваш_ключ

Ключ доступен в личном кабинете.

POST /v1/check

Полная проверка текста: стиль, орфография, метрики, score.

Request
{
  "text": "Ваш текст...",
  "options": {
    "checks": ["style", "spelling",
      "typography", "metrics"]
  }
}
Response
{
  "score": 72,
  "verdict": "needs_work",
  "stats": { "words": 186, ... },
  "metrics": {
    "water_pct": 28.4,
    "nausea_classic": 4.1,
    ...
  },
  "issues": [{
    "rule": "bureaucratese",
    "severity": "medium",
    "snippet": "является",
    "suggestion": "—"
  }]
}

POST /v1/typography

Исправляет типографику: кавычки, тире, неразрывные пробелы.

// Request
{ "text": "Он сказал \"привет\" - и ушел." }

// Response
{ "text": "Он сказал «привет» — и ушёл.", "fixes_applied": 3 }

POST /v1/stats

Статистика и метрики без стилистических проверок.

// Response
{ "words": 186, "chars": 1240, "water_pct": 28.4,
  "nausea_classic": 4.1, "readability": "normal" }

Ошибки

HTTPerrorОписание
400invalid_requestПустой текст или невалидный JSON
401unauthorizedНет или невалидный API-ключ
403plan_limit_reachedКвота символов исчерпана
413text_too_largeТекст превышает лимит тарифа
429rate_limit_exceededСлишком много запросов

Лимиты

ТарифСимволов/месМакс. текстЗапросов/мин
Free50 0005 00010
Старт500 00025 00030
Про2 000 00050 00060
Команда10 000 000100 000120