Killer-antiplagiat API

Для партнеров предлагаем API к услугам нашего сервиса Killer-antiplagiat
Для уточнения тарифов и технических особенностей обращайтесь на почту [email protected]

Интеграция в ваш сайт

Наш сервис позволяет легко, быстро и безопасно интегрировать в ваш сервис систему повышения уникальности текста

Гибкие тарифы

Для партнеров мы разработали гибкие тарифы на подключение

Безопасность хранения данных

Мы используем облачный сервис и не храним ваши данные. Документы удаляются с наших серверов

Множество услуг

Мы предоставляем API для всех основных услуг сайта: повышение уникальности кодировкой, авторерайт, и синонимайзер текста

Техническая поддержка

Предоставляем круглосуточную техническую поддержку

Быстрая и легкая настройка

Наш сервис максимально удобен, полную инструкцию к подключению прилагаем.

Общие положения

Используется RESTful архитектура, методы GET, PUT, POST, DELETE.
Результаты команд возвращаются в формате JSON. (Исключение - возвращение результатов)
API работает по протоколу HTTPS.
API работает через формат JSON (Content-Type: application/json). Исключение - загрузка файлов.

Авторизация

Авторизация запросов производится при помощи JWT (JSON Web Token) в заголовке с названием Authorization: Authorization: <JSON Web Token> Как получить токен? Токен предоставляет администратор системы.

Работа с файлами

Загрузка файла, метод POST
Поддерживается два способа загрузки файлов.
Первый способ - загрузка как Multipart Form (Content-Type: multipart/form-data). В форме должно быть поле file, содержащее бинарные данные. Заголовок Content-Disposition должен содержать название файла (filename).
Второй способ - прямая загрузка бинарных данных, при этом в Content-Type указывается MIME-тип данных. При этом название файла будет сгенерированно системой.
Максимальный размер файла - 15 Мб
Поддерживаются следующие форматы: application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/msword, application/rtf.

Информация о загруженных файлах, метод GET
В системе храниться основная информация о загруженных файлах: уникальный идентификатор, название, размер и признак удаления.
Один файл можно использовать несколько раз в рамках одной или нескольких услуг.

Изменение информации о загруженных файлах, метод PATCH
Есть возможность переименовать загруженный файл (например, после прямой загрузки). Для этого нужно передать название и идентификатор файла

Удаление файлов, метод DELETE
После завершения манипуляций с файлами, рекомендуется их удалять.

Доступные сервисы

В данных момент API поддерживает следующие сервисы:

Бесплатную обработку (/api/trial)
Повышение уникальности (/api/increase)
Синонимайзер (/api/synonimizer)
Рерайт (/api/rewrite)

В результате выполнения запросов на выполнение услуг возвращаются:

идентификатор запущенной работы (JobId)
оставшееся количество обработок по данной услуге (ServicesLeft)

Бесплатная обработка
Принимает параметры:

File - идентификатор файла
Percent - процент уникальности (от 1 до 100)

Повышение уникальности
Принимает параметры:

File - идентификатор файла
Percent - процент уникальности (от 1 до 100)
Mode - режим обработки (от type1 до type8)

Каждые 150000 символов в рамках одного документа являются одной обработкой.
Синонимайзер
Принимает параметры:

Source - исходный текст

Каждые 150000 символов в рамках одного текста являются одной обработкой, т.е. текст на 200000 символов использует две обработки.
Рерайт
Принимает один из параметров:

File - идентификатор файла
Source - исходный текст

Т.е. рерайт может работать как с файлами, так и текстом. Если будут переданы оба параметра, параметр Source игнорируется.
Каждые 150000 символов в рамках одного текста или документа являются одной обработкой.

Ожидание работы

После выполнения запроса на обработку текста или документа, возвращается идентификатор запущенной работы (JobId). Для получения состояния готовности работы служит метод GET /api/jobs.
В результате выполнения запроса о готовности возвращаются данные:

статус работы (Status)
результат работы (Result)

Статус может иметь следующие значения:

in progress - в работе, т.е. обработка еще не закончилась
finished successfully - успешно завершено, работа закончена и можно получать результат
failed - завершено с ошибкой, произошла внутреняя ошибка, следует обратиться в поддержку

Результат работы содержит ссылку, по которой можно получить итоговый файл или текст.

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

Система возвращает следующие результаты, в зависимости от используемого сервиса:

Бесплатная обработка - возвращается архив, содержащий обработанные файлы
Повышение уникальности - возвращается обработанный файл
Синонимайзер - возвращается обработанный текст
Рерайт - возывращается обработанный текст или файл, в зависимости от того, что было передано

Swagger документация по методам: просмотреть