api сервисов для работы с текстом
Для доступа к api необходимо войти в личный кабинет, пополнить баланс и записать свои user_id и api_key.
Стоимость равна стоимости PRO версии.
Ограничения - 60 запросов в минуту.
История проверок доступна в личном кабинете.
Результат проверки хранится 7 дней.
Расставить запятые и проверка пунктуации
Отправка
Отправить текст на проверку пунктуации - POST https://textovod.com/api/punctuation/user/add (запросы в кодировке UTF-8, json в теле)
{ "user_id": свой id, "api_key":"свой key", "text": “ваш текст”, “lang”: “ru, en, fr, es, de, it, pt” }
Ответы
Если Добавлен новый текст: {"status": от 0 до 3, "text_id":"id текста для получения статуса"}.
Статусы: 0 - ошибка, 3 - в очереди, 1 - обработка, 2 - готово.
Если текст уже проверяли: результат проверки (см. ниже)
Результат
Получить результат - POST https://textovod.com/api/punctuation/user/status
{ "user_id": свой id, "api_key":"свой key", "text_id": "id текста" }
Ответы
Если статус проверки равен 2, то возвращается результат:
{"status":2, "punctuation":"результат проверки", "text_id":"id текста",
"result": {
"punctuation": [
{
"paragraph": [
{
"offset": номер позиции
"length": длина,
"mes": "вид сообщения"
},
…
]
},
….
],
"statistics": {
"add": количество добавлений,
"delete": количество удаленных,
"register": количество изменений регистра,
"ok": количество правильных знаков
}
},
"text": "Исходный текст",
"resultText": [
"Используемый исходный текст с разбивкой на абзацы, относительно которого задаются положения знаков"
]
}
Знаки, которые расставила система находятся в теге <mark>.
Если текст превышает 100 тыс. символов, он будет обрезан до 100 тыс. символов.
Результат делится на абзацы. Для максимального совпадения разметки с api проверки орфографии необходимо оставлять в тексте только буквы, пробелы, переносы строк и знаки . , ? ! : ; -
Проверка орфографии
Отправить текст на проверку орфографии - POST https://textovod.com/api/spelling/user/add (запросы в кодировке UTF-8, json в теле)
{ "user_id": свой id, "api_key":"свой key", "text": "ваш текст" }
Ответ
{
"status": 1, (0 - ошибка, 1 - готово)
"result": "[{"offset":Позиция, "length":Длина,"mes":"Описание","rep":[варианты]},{"offset":0, "length":11, "mes":"Описание","rep":[]}]",
"count": Количество возможных ошибок,
"text": "Ваш текст с обработкой на сервере",
"text_id": "id текста"
}
Получить готовый результат
Получить результат - POST https://textovod.com/api/spelling/user/status
{ "user_id": свой id, "api_key":"свой key", "text_id": "id текста" }
Ответ подобен ответу из add
Проверка уникальности текста
Отправка
Отправить текст на проверку пунктуации - POST https://textovod.com/api/unique/user/add (запросы в кодировке UTF-8, json в теле)
{ "user_id": свой id, "api_key":"свой key", "text": "ваш текст" }
Ответы
Если Добавлен новый текст: {"status": от 0 до 3, "text_id":"id текста для получения статуса"}.
Статусы: 0 - ошибка, 3 - в очереди, 1 - обработка, 2 - готово.
Если текст уже проверяли: результат проверки (см. ниже)
Результат
Получить результат - POST https://textovod.com/api/unique/user/status
{ "user_id": свой id, "api_key":"свой key", "text_id": "id текста" }
Ответы
Если статус проверки равен 2, то возвращается результат:
{
"status": 2,
"text_id": "id проверки",
"originality": уникальность,
"position": "позиции слов",
"text": "ваш текст ",
"urls": "[{"url":"адрес источника", "domain": "домен источника", "position": "позиции слов", "similarity": % совпадений}, …]" - источники
}
Минимальный объем текста - 100 символов.
Если текст превышает 200 тыс. символов, он будет обрезан до 200 тыс. символов.