API

API сервиса «Typographie» позволяет воспользоваться его преимуществами, независимо от того, пишите вы веб-приложение, десктопное или для мобильных устройств: всё, что вам понадобится — это доступ к интернету.

Для того, чтобы «оттипографировать» текст, вам необходимо выполнить HTTP-запрос методом POST на адрес https://api.typographie.ru/.

Параметры

raw (обязательный) : Текст, нуждающийся в обработке.
actions : Список совершаемых операций, через запятую (по умолчанию — все).
in : Тип вводимого текста, plain (по умолчанию) или html.
out : Тип получаемого текста, plain (по умолчанию) или html.

Рабочая кодировка — UTF-8.

Действия (actions)

quotes : Замена кавычек: "" на «».
inquot (требует quotes): Вложенные кавычки: «„“» (иначе — дублирующие кавычки «склеиваются»).
dashes : По необходимости заменять дефисы на тире и минусы.
angles : Заменять звёздочки и кавычки на градусы, футы, дюймы.
dblspace : Исправлять дублирующиеся пробелы в тексте.
specials : Вставлять специальные символы (из таблицы символов).
mathchars : Вставлять математические символы (из той же таблицы).
punctuation : Исправлять ошибки в пунктуации, например, пробелы перед запятыми.
specialspaces : Исправлять неправильную отбивку спецсимволов пробелами.
nbsp : «Приклеивать» короткие слова к следующим в тексте.
hellip : Исправлять многоточия на символ «троеточие».
paragraphs : Расставлять параграфы (<p>) при конвертации в HTML (через пустые строки).
safehtml : Не обрабатывать текст внутри HTML-тэгов <code> и <pre>.

Список действий перечисляется через запятую, вида action1,action2,action3.

Пример ответа

Ответ приходит в формате JSON.

{"version":"1.3.0","result":"Your text."}

Коды ошибок

BAD_REQUEST : Не получен обязательный параметр — текст для обработки (raw).
ACTIONLIST_EMPTY : Не указано ни одно действие. Все действия — не передавайте actions вообще
ACTIONLIST_INVALID : В списке действий найдены несуществующие.
INPUT_MODE_INVALID : Неверный тип входного текста.
OUTPUT_MODE_INVALID : Неверный тип получаемого текста.