Plagiarismi avastamise API: esitada tekst, küsitleda aruande.
Käputäis tulemusnäitajaid, esitaja author, läbipaistev krediidi hinnakujundus. Ehitatud agentuuridele, toimetus torujuhtmetele ja LMS-kõrvaltööriistadele.
API võti
Logi sisse, et saada oma API võti. Võtmed tulevad iga konto; API kontrolli arve krediiti.
RegistreeruTulemusnäitajad
POST /api/v1/check/
Saatke kontrollimiseks tekst. Tagastab 202 kontroll_ id. Keha: JSON tekstiväljaga, vabatahtlik sügav tõeväärtus.
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>/
Küsitlus staatuse kohta; kui staatus on tehtud, lisatakse täielik aruanne: skoor, ühemeelelisusega matðitüübid koos usalduse ja allikate väljavõtetega ning lähteandmete nimekiri.
curl https://plagiarism.free/api/v1/check/CHECK_ID/ \ -H "Authorization: Bearer YOUR_KEY"
GET /api/v1/checks/
Loetle oma viimaseid kontrolle, kõigepealt uusim. Valikulised päringuparamid: piirang (1- 100, vaikimisi 20) ja staatus (queued, tehtud, nurjus...). Reconcile esildised ja tagasi oma armatuurlaud ilma iga check_ id- i salvestamata.
curl "https://plagiarism.free/api/v1/checks/?limit=20&status=done" \ -H "Authorization: Bearer YOUR_KEY"
DELETE /api/v1/check/<check_id>/
Kustutada lõpetatud kontroll: esitatud tekst ja selle aruanne eemaldatakse lõplikult. Kasuta seda, et täita oma kasutajate kustutamissoovid. Kontrollimine, mis on ikka järjekorda pandud või töötab vastuseid 409; kustuta see, kui see on tehtud või nurjunud.
curl -X DELETE https://plagiarism.free/api/v1/check/CHECK_ID/ \ -H "Authorization: Bearer YOUR_KEY"
Pythoni näide
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"])
JavaScripti näide
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));
Hinnakujundus
Sama, mis saidil: 1 krediit = 1000 sõna skaneeritud, ümardatud iga kontrolli; sügav kontroll maksab topelt. Krediitpaketid kehtivad 365 päeva; tellimused täita iga kuu ja lisada API igal tasandil. Ei eraldi API tase, ei ühe koha kohta tasud. Vt plaanid ja pakendid
Kontroll toimub asünkroonselt: tegelik, määra-piiratud veebiotsingu tavaliselt võtab umbes minut, kui kontroll algab, pikem pikk dokumente ja hõivatud ajal. Küsi staatuse tulemusnäitaja asemel hoida ühendus avatud. HTTP 402 tähendab ebapiisav krediiti; vastus sisaldab, mida kontroll maksaks.