盗作検出 API: テキストを提出し、レポートをポールします。
少数のエンドポイント、持ち主認証、透明なクレジット価格。機関、編集パイプライン、LMSに隣接するツールのために作成。
エンドポイント
POST /api/v1/check/
チェックするテキストを送信します。check_id と共に 202 を返します。ボディ: 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) と状態 (キュー、完了、失敗... ) です。すべての 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 クレジット = 1,000 単語スキャン、チェックごとに丸め、ディープチェックは2倍のコスト。クレジットパックは 365 日有効で、サブスクリプションは月ごとにリフィルされ、すべてのレベルの API を含む。別の API 階層もなく、シートごとの料金もありません。 プランとパッケージを見る
チェックは非同期的に実行されます。実際の速度制限のウェブ検索は、チェックが開始されると通常約 1 分かかります。長い文書や忙しい時間帯では、より長くかかります。接続を開いているままにする代わりに、状態エンドポイントをポールします。HTTP 402 はクレジットが不足していることを意味します。チェックのコストを反応に含むでしょう。