API синонимайзера, рерайтера, перефразировщика предложений - Sinoni.men

POST запросы отправлять на api.sinoni.men


Отправляете задание на синонимацию текста


Параметр: token - ваш токен, который вы получаете в панели управления;

Параметр: text - ваш текст, который требуется уникализировать;

Параметр: lang - язык, на котором написан ваш текст;

Доп. параметр: unique - проверять уникальность (по умолчанию как настроено в профиле true/false);

Доп. параметр: double - двойной рерайт (по умолчанию как настроено в профиле true/false);

Доп. параметр: webhook - URL-адрес (на этот URL будет отправлен POST запрос с результатом).

При успешном принятии текста в задание, вы получите уникальный ID.

    {
        "status": "success",
        "result": {
            "id": "00fd4b4549a1094aae926ef62e9dbd3cdcc2e456",
            "token": "8aee7ab77891731083d21b853d6ef12ca044beff"
        }
    }

По этому ID в следующем запросе получите результат синонимации вашего текста. Если в запросе указан параметр webhook, то результат будет отправлен автоматически, как только будет готов, на указанный URL-адрес (например: https://example.com/webhook) в виде JSON.


Получение результата рерайта текста


Параметр: id - ID текста, который хотите получить;

Параметр: token - ваш токен, который вы получаете в панели управления.

Если ваш рерайт уже готов, вы получите JSON ответ.

    {
        "status": "success",
        "result": {
            "percent": 43.02,
            "words": 2034,
            "spam": 20,
            "water": 34,
            "rewrite": "Ваш рерайт",
            "chars": 100000,
            "double": false,
            "unique": true
        }
    }

Если же ваш текст еще проходит обработку, результат будет ошибка с кодом 101.

    {
        "status": "error",
        "error": {
            "code": 101,
            "msg": "Ваш текст еще не готов"
        }
    }

Список возможных ошибок при работе с API


101 - Ваш текст еще не готов

102 - Пожалуйста, заполните поле «token»

103 - Пожалуйста, заполните поле «lang»

104 - Пожалуйста, заполните поле «text»

105 - Поле «text» должно состоять из букв русского алфавита

106 - В поле «text» должно быть от 100 символов

107 - В поле «text» Вы вышли за пределы лимита

108 - Пользователь не существует

109 - API не активировано


Простой пример работы curl/wget


Отправка текста в задание

    curl --header "Content-Type: application/x-www-form-urlencoded" \
        --request POST \
        --data "token=8aee7ab77891731083d21b853d6ef12ca044beff&lang=ru&text=Ваша статья" \
        https://api.sinoni.men

или wget

    wget -qO- --header="Content-Type: application/x-www-form-urlencoded" \
        --post-data="token=8aee7ab77891731083d21b853d6ef12ca044beff&lang=ru&text=Ваша статья" \
        https://api.sinoni.men

Получение ID задания

    {
        "status": "success",
        "result": {
            "id": "85e56fca1ceb552d247ad5f2f312897cf298bcba",
            "token":"8aee7ab77891731083d21b853d6ef12ca044beff"
        }
    }

Проверка ID задания

    curl --header "Content-Type: application/x-www-form-urlencoded" \
        --request POST \
        --data "token=8aee7ab77891731083d21b853d6ef12ca044beff&id=85e56fca1ceb552d247ad5f2f312897cf298bcba" \
        https://api.sinoni.men

или wget

    wget -qO- --header="Content-Type: application/x-www-form-urlencoded" \
        --post-data="token=8aee7ab77891731083d21b853d6ef12ca044beff&id=85e56fca1ceb552d247ad5f2f312897cf298bcba" \
        https://api.sinoni.men

Получение результата

    {
        "status": "success",
        "result": {
            "rewrite": "Ваш рерайт",
            "percent": 70.7, // Уникальность рерайта
            "words": 345,    // Число слов
            "spam": 32,      // Уровень спама
            "water": 15,     // Воды в тексте
            "chars": 100000, // Осталось символов
            "double": true,  // Двойной рерайт включен
            "unique": true   // Проверка уникальности включена
        }
    }

Простой пример работы на NodeJS


Установка пакета sinoni

    npm i sinoni
    const sinoni = require('sinoni');
    sinoni({
        token: "8aee7ab77891731083d21b853d6ef12ca044beff",
        text: "Ваша статья",
        lang: "ru"
    }).then(res => {
        console.log(res.rewrite); // Ваш рерайт
    }).catch(console.error);