ВерноСловВерноСлов

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

API ВерноСлов позволяет интегрировать проверку текстов в ваши системы. Базовый адрес: https://vernoslov.ru/api/v1

Авторизация

Для платных проверок передайте ключ в поле token тела запроса. Бесплатная проверка слов не требует ключа.

Маршруты

POST/api/v1/words/check

Проверка одного слова. Бесплатно, без ключа.

Запрос:

{
  "word": "дедлайн"
}

Ответ:

{
  "word": "дедлайн",
  "lemma": "дедлайн",
  "found": false,
  "reason": "not_found",
  "message": "Слово не найдено в нормативных словарях"
}
POST/api/v1/validationsТребуется ключ

Создать проверку текста, файла или ссылки.

Запрос (текст):

{
  "type": "text",
  "content": "Текст для проверки",
  "token": "ваш-ключ"
}

Запрос (ссылка):

{
  "type": "link",
  "url": "https://example.com",
  "token": "ваш-ключ"
}

Ответ:

{
  "id": "uuid",
  "status": "completed",
  "type": "text"
}

Тексты до 700 символов можно проверять без ключа (базовые правила). Файлы и ссылки всегда требуют ключ.

GET/api/v1/validations/{id}

Получить результат проверки по идентификатору.

Ответ:

{
  "id": "uuid",
  "status": "completed",
  "type": "text",
  "rules_type": "extended",
  "characters_count": 1234,
  "result": {
    "total_words": 200,
    "total_characters": 1234,
    "foreign_count": 3,
    "foreign_words": [...],
    "text_with_highlights": "<mark>...</mark>"
  },
  "created_at": "2026-01-01T12:00:00Z",
  "completed_at": "2026-01-01T12:00:01Z"
}
GET/api/v1/tokens/stats?token=КЛЮЧТребуется ключ

Получить статистику использования ключа.

Ответ:

{
  "token": "ваш-ключ",
  "totalCharacters": 100000,
  "usedCharacters": 5432,
  "remainingCharacters": 94568,
  "isActive": true
}
GET/api/v1/payments/tariffs

Список доступных тарифов.

Ответ:

[
  {
    "id": "uuid",
    "characters": 20000,
    "price_per_char": "0.0145",
    "total_price": "290",
    "label": "Базовый",
    "description": "~10 статей",
    "sort_order": 1
  }
]
GET/api/v1/blog

Список опубликованных статей блога.

GET/api/v1/blog/{slug}

Получить статью блога по URL-адресу.

Ограничения

  • Ограничение: 10 запросов в секунду с одного IP-адреса
  • Максимальный размер файла: 5 МБ
  • Поддерживаемые форматы файлов: PDF, DOC, DOCX, TXT, HTML, XLSX
  • Результаты проверок хранятся 72 часа
  • Формат ошибок: {"error": "string", "message": "string", "statusCode": number}

Для работы с API необходим ключ. Приобрести ключ →