API-и муайянкунии плагиат: матнро фиристед, гузоришро пурсед.
Якчанд нуқтаҳои охирин, аутентификатсияи соҳиб, нархгузории шаффоф. Барои агентиҳо, каналҳои таҳрирӣ ва асбобҳои LMS-и ҳамсоя сохта шудааст.
Калиди API- и шумо
Барои гирифтани калиди API-и худ ворид шавед. Калидҳо бо ҳар як ҳисоби корбар меоянд; санҷиши API дар кредитҳо ҳисоб карда мешавад.
БақайдгирӣНуқтаҳои охирин
POST /api/v1/check/
Матнро барои санҷиш фиристед. 202- ро бо check_ id бармегардонад. Ҷисми: JSON бо матни замина, интихобии чуқурии 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>/
Дар ин ҷо шумо метавонед ба саволҳои зерин ҷавоб диҳед: 1.
curl https://plagiarism.free/api/v1/check/CHECK_ID/ \ -H "Authorization: Bearer YOUR_KEY"
GET /api/v1/checks/
Рӯйхати санҷишҳои охирини шумо, навтарин дар аввал. Параметри пурсишҳои иловагӣ: ҳадди (1- 100, пешфарз 20) ва ҳолати (дар навбат, анҷом, хатогӣ...). Мувофиқати пешниҳодҳо ва барқароркунии панели худ бе нигоҳ доштани ҳар як check_ 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 кредит = 1000 калимаҳои сканшуда, гирд карда барои ҳар як санҷиш; санҷишҳои чуқур ду баробар гаронтар аст. Пакети кредитҳо 365 рӯз амал мекунанд; обунаҳо ҳар моҳ пур карда мешаванд ва API- ро дар ҳар дараҷа дар бар мегиранд. Ягон дараҷаи API- и алоҳида, ягон пардохт барои ҳар як ҷой. Нигоҳ доштани нақшаҳо ва бастаҳо
Санҷишҳо ғайри ҳамзамона иҷро мешаванд: гирифтани веби воқеӣ, бо суръати маҳдуд, одатан як дақиқаро мегирад, вақте ки санҷиш оғоз мешавад, барои ҳуҷҷатҳои дарозтар ва дар вақти серодамтар. Ба ҷои нигоҳ доштани пайвастшавӣ кушода, ҳолати нуқтаи охиринро пурсидан. HTTP 402 маънои кредитҳои нокифоя дорад; ҷавоб арзиши санҷишро дар бар мегирад.