Plagiarisme - opsporing API: stuur teks neer, sê die verslag.
'n Handvol punte, draer' nuth, deursigtige kredietprysing. Gebou vir agentskappe, redaksionele pypleidings en LMS-dalade gereedskap.
Jou API-sleutel
Teken in om jou API-sleutel te kry. Sleutels kom met elke rekening; API-kontroles word in krediete aangeteken.
Meld opEinde punt:
POST /api/v1/check/
Dien ’n teks in vir kontrole. Gee 202 terug met ’n check_id. Liggaam: JSON met ’n text-veld en opsionele deep-boolean.
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>/
Pos vir status; wanneer status is klaar die volledige raporteer is ingesluit: telling, per-enteniteit ooreenstem tipes met vertroue en bron uittreksels, en die bronlys.
curl https://plagiarism.free/api/v1/check/CHECK_ID/ \ -H "Authorization: Bearer YOUR_KEY"
GET /api/v1/checks/
Lys jou onlangse kontroles, nuutste eerste. Opsionele navraagparameters: limit (1 tot 100, standaard 20) en status (queued, done, failed...). Versoen indienings en voed jou eie paneelbord sonder om elke check_id te stoor.
curl "https://plagiarism.free/api/v1/checks/?limit=20&status=done" \ -H "Authorization: Bearer YOUR_KEY"
DELETE /api/v1/check/<check_id>/
Delete a finished check: the submitted text and its report are removed for good. Use it to honour your own users' deletion requests. A check that is still queued or running answers 409; delete it once it is done or failed.
curl -X DELETE https://plagiarism.free/api/v1/check/CHECK_ID/ \ -H "Authorization: Bearer YOUR_KEY"
Python-voorbeeld
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 voorbeeld
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));
Comment
Identies aan die webwerf: 1 krediet = 1,000 woorde geskandeer, per kontrole afgerond na bo; diepkontroles kos dubbel. Kredietpakkies is 365 dae geldig; intekeninge word maandeliks aangevul en sluit die API op elke vlak in. Geen aparte API-vlak nie, geen gelde per sitplek nie. Sien planne en pakkies
Kontroles loop asynchroon: werklike, tempo-beperkte webherwinning neem gewoonlik ongeveer ’n minuut sodra ’n kontrole begin, langer vir lang dokumente en op besige tye. Vra die statuseindpunt op in plaas van die verbinding oop te hou. HTTP 402 beteken onvoldoende krediete; die antwoord sluit in wat die kontrole sou kos.