АПИ плагиатной системы: представить текст, опросить отчёт.
Несколько конечных точек, аут-нос, прозрачное кредитное ценообразование, построенное для агентств, редакционного оборудования и смежных с ЛМС инструментов.
Ключ от API
Войдите, чтобы получить ключ API. Ключ есть у каждого аккаунта; проверки через API оплачиваются кредитами.
ПодпишитесьКонечные точки
POST /api/v1/check/
Направьте текст для проверки. Возвращает 202 с чек_id. Тело: JSON с текстовым полем, факультативная глубокая булевая.
curl -X POST https://plagiarism.free/api/v1/check/ \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "The text you want to check..."}'
GET /api/v1/check/<check_id>/
Вопрос о статусе; когда будет сделано полное представление, в него включаются: баллы, типы, соответствующие каждому требованию, с уверенностью и выдержки из источников, а также список источников.
curl https://plagiarism.free/api/v1/check/CHECK_ID/ \ -H "Authorization: Bearer YOUR_KEY"
GET /api/v1/checks/
Перечислите ваши последние проверки, сначала новые. Факультативные запросы парам: предел (1-100, по умолчанию 20) и статус (записано, сделано, не выполнено). Выверьте представления и отправьте назад свою собственную панель без хранения каждого чек_id.
curl "https://plagiarism.free/api/v1/checks/?limit=20&status=done" \ -H "Authorization: Bearer YOUR_KEY"
DELETE /api/v1/check/<check_id>/
Исключить завершенную проверку: представленный текст и его Пожаловаться удаляются навсегда. Используйте его, чтобы выполнить запросы пользователей. Проверка, которая все еще в очереди или в режиме поиска ответов 409; удалить ее после завершения или отказа.
curl -X DELETE https://plagiarism.free/api/v1/check/CHECK_ID/ \ -H "Authorization: Bearer YOUR_KEY"
Пример Python
import time
import requests
API = "https://plagiarism.free/api/v1/check/"
HEADERS = {"Authorization": "Bearer YOUR_KEY"}
r = requests.post(API, json={"text": open("essay.txt").read()}, headers=HEADERS)
check_id = r.json()["check_id"]
while True:
report = requests.get(f"{API}{check_id}/", headers=HEADERS).json()
if report["status"] in ("done", "failed"):
break
time.sleep(3)
print(report["score_pct"], "% matched")
for source in report["sources"]:
print(source["pct_of_document"], source["url"])
Пример JavaScript
const API = "https://plagiarism.free/api/v1/check/";
const headers = { "Authorization": "Bearer YOUR_KEY", "Content-Type": "application/json" };
const { check_id } = await fetch(API, {
method: "POST", headers, body: JSON.stringify({ text })
}).then(r => r.json());
let report;
do {
await new Promise(res => setTimeout(res, 3000));
report = await fetch(`${API}${check_id}/`, { headers }).then(r => r.json());
} while (!["done", "failed"].includes(report.status));
Ценообразование
Так же, как на сайте: 1 кредит = 1 000 просканированных слов, округление вверх за каждую проверку; глубокие проверки стоят вдвое дороже. Пакеты кредитов действуют 365 дней; подписки пополняются ежемесячно и включают API на каждом уровне. Отдельного тарифа для API и платы за места нет. Посмотри на планы и пачки
Проверки выполняются асинхронно: реальный поиск в сети с ограничением частоты обычно занимает около минуты после запуска проверки, дольше для длинных документов и в часы пиковой нагрузки. Опрашивайте конечную точку статуса, а не держите соединение открытым. HTTP 402 означает, что кредитов недостаточно; в ответе указано, во сколько обошлась бы проверка.