API تشخیص تقلب: ارسال متن، پرس و جو گزارش.
چند تا نقطه انتهايي، امضاي حامل، قيمت شفافي اعتباري براي آژانس ها، خط توليد و ابزارهاي مجاور LMS ساخته شده
کلید API شما
برای دریافت کلید API وارد شوید. هر حساب یک کلید دارد؛ بررسیهای API با اعتبار محاسبه میشوند.
ثبت نامنقطه پایانی
POST /api/v1/check/
ارسال متن برای بررسی. پاسخ 202 همراه با check_id برمیگرداند. بدنه: JSON با فیلد text و فیلد اختیاری بولی deep.
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/
فهرست بررسیهای اخیر شما، از جدیدترین به قدیمیترین. پارامترهای اختیاری پرسوجو: limit (از 1 تا 100، پیشفرض 20) و status (queued، done، failed و غیره). ثبتها را تطبیق دهید و داشبورد خودتان را بدون ذخیره هر 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"
مثال پایتون
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"])
مثال جاوااسکریپت
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 یعنی اعتبار کافی نیست؛ پاسخ شامل هزینه بررسی نیز هست.