API: поднесете текст, а потоа го разгледајте извештајот.
Неколку крајни точки, автентичност на носачот, транспарентни кредитни цени, изградени за агенции, уреднички гасоводи и ЛМС-апарати.
Вашиот API клуч
Најавете се за да добиете API клуч. Секоја сметка има клуч; проверките преку API се наплаќаат во кредити.
Потпиши сеКрајни точки
POST /api/v1/check/
Препраќа текст за проверка. Враќа 202 со check_ 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) и статус (наведено, завршено, неуспешно...). Реконцилирајте ги податоците и назад на вашата табла со инструменти без да го зачувате секој чек_ ид.
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 значи недоволно кредити; одговорот ја содржи цената на проверката.