API fanaraha-maso ny fandikana: mandefa lahatsoratra, mifidy ny tatitra.

Endpoints maro, fanamarinana ny mpitondra, fividianana amin'ny vidiny mazava. Natao ho an'ny masoivoho, fanoratana sy fitaovana mifanakaiky amin'ny LMS.

Ny famaha API-nao

Miditra mba hahazoana ny famaha API-nao. Miaraka amin'ny kaonty tsirairay ny famaha; ny fitsapana API dia atao amin'ny alalan'ny credits.

Misoratra anarana

_Toerana farany

POST /api/v1/check/

Mandefa lahabolana hojerena. 202 miaraka amin'ny check_id no omeny. Body: JSON misy sehatr'asa, boolean lalina safidy.

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>/

Ny fiteny dia mizara ho sokajy telo: ny fiteny fototra, ny fiteny fototra izay ahitana ny teny rehetra, ary ny fiteny fototra izay ahitana ny teny rehetra.

curl https://plagiarism.free/api/v1/check/CHECK_ID/ \
  -H "Authorization: Bearer YOUR_KEY"

GET /api/v1/checks/

Mampiseho ireo fitsapanao farany, ny vaovao indrindra aloha. Parametatra safidy: fetra (1-100, 20 tsotra) sy ny toe-javatra (efa miandry, vita, tsy nahomby...). Mifandraisa amin'ny fandefasana ary apetraho amin'ny takelaka kelin'ny mpampiasa tsy misy fitahirizana check_id tsirairay.

curl "https://plagiarism.free/api/v1/checks/?limit=20&status=done" \
  -H "Authorization: Bearer YOUR_KEY"

Ohatra amin'ny 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"])

Ohatra 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));

Famaritana ny vidin'ny entana

Mitovy amin'ny tranonkala: 1 credit = teny 1000 nojerena, namboarina ho 100 ny isan'ny fijerena; ny fijerena lalina dia mitentina avo roa heny. Ny karatra dia mitombina mandritra ny 365 andro; ny fidirana dia miverina isan-bolana ary ahitana ny API amin'ny ambaratonga rehetra. Tsy misy ambaratonga API manokana, tsy misy sarany isan-toerana. Jereo ny drafitra sy ny fonosana

Tsy mifanaraka amin'ny fotoana ny fitsapana (20-45 segondra ny fidirana amin'ny tranonkala tena izy, voafetra amin'ny hafainganam-pandeha) - mitady ny farany amin'ny toe-draharaha fa tsy miandry ny fifandraisana misokatra. Ny HTTP 402 dia midika hoe tsy ampy ny credits; ahitana ny vidin'ny fitsapana ny valinteny.

Fanontaniana matetika

Two endpoints. POST /api/v1/check/ with your text returns a check_id; GET /api/v1/check/check_id/ returns status while the check runs and the full report JSON (score, matched sentences, sources) when done. Auth is a Bearer key from your account page. Code samples in curl, Python and JavaScript are below.

The same transparent unit as the site: 1 credit per 1,000 words scanned, rounded up per check. Credit packs start at $4.99 for 30 credits and are valid a full year; the $7.99/month Starter plan includes 60 credits and API access. No per-seat fees, no separate API pricing tier.

A check takes roughly 20-45 seconds because it performs real, rate-limited web retrieval and page comparison - the API is asynchronous for that reason. Submissions queue fairly; paid checks get priority. Poll the status endpoint every few seconds rather than holding the connection open.

Everything the web report shows: overall matched percentage, per-sentence match type (exact / near / none) with confidence, the matched source excerpt for each flagged sentence, and the source list with URLs and per-source match percentages. Enough to render your own report UI or gate a workflow.

Yes - that is what it is for: LMS-adjacent tools, editorial workflows, agency content pipelines. Volume is metered purely by credits, and the per-check word cap is 25000 words. If you need sustained high volume, contact us and we will provision for it rather than let queues degrade.