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" }
Ошибки
| HTTP | error | Описание |
|---|---|---|
| 400 | invalid_request | Пустой текст или невалидный JSON |
| 401 | unauthorized | Нет или невалидный API-ключ |
| 403 | plan_limit_reached | Квота символов исчерпана |
| 413 | text_too_large | Текст превышает лимит тарифа |
| 429 | rate_limit_exceeded | Слишком много запросов |
Лимиты
| Тариф | Символов/мес | Макс. текст | Запросов/мин |
|---|---|---|---|
| Free | 50 000 | 5 000 | 10 |
| Старт | 500 000 | 25 000 | 30 |
| Про | 2 000 000 | 50 000 | 60 |
| Команда | 10 000 000 | 100 000 | 120 |