Tekst erin, resultaat eruit
Het REST-contract vereist één tekstveld. Daardoor voeg je de controle eenvoudig toe aan een bestaande inzendings- of redactieworkflow.
REST API / plagiaatanalyse
Plagiaatchecker-API voor bronbewuste beoordeling
Voeg plagiaat- en bronanalyse toe aan een schrijf-, onderwijs- of publicatieproduct zonder beoordelaars naar een aparte tool te sturen. Verstuur de tekst vanaf je server en toon het resultaat in hun bestaande workflow.
Gebruik de sleutel uit een privéserveromgeving.
cURL-verzoek
curl --request POST \
--url https://api.detecting-ai.com/api/plagiarism/ \
--header "Content-Type: application/json" \
--header "Idempotency-Key: plagiarism-review-001" \
--header "X-API-Key: YOUR_API_KEY" \
--data '{
"text": "Paste the text you want to check."
}'01
POST-verzoeken naar /api/plagiarism/
02
Authenticatie met X-API-Key
03
Idempotency-Key van de client voor veilige nieuwe pogingen
04
Eén verplicht tekstveld
05
Afzonderlijke woordlimiet voor deze functie
Houd de bron in het gesprek
Een overeenkomst is pas nuttig als de beoordelaar kan nagaan waardoor die ontstaat
De API levert een resultaat voor bronoverlap en gebruiksgegevens. Koppel dat resultaat in je interface aan de ingediende passage, de beschikbare broncontext en de regels die voor de beoordelaar gelden.
Standaard aan de serverzijde
Houd de klantsleutel uit de browser en retourneer alleen de rapportgegevens die je toepassing bereid is toe te lichten.
Beoordeling vóór actie
Beschouw overlap als een aanknopingspunt voor broncontrole. Citaten, toestemming en beleid bepalen wat een overeenkomst in de praktijk betekent.
Verzoekcontract
De requestbody heeft één taak
Verzend de volledige tekst die je wilt controleren als een tekenreeks in JSON. Verwerk documentontleding, toegangscontrole en eventuele metadata van inzendingen in je eigen toepassing.
| Veld | Type | Vereist | Wat het doet |
|---|---|---|---|
| text | string | Ja | De tekst die je door de plagiaatdienst wilt laten analyseren. |
Inspecteer het geretourneerde resultaat voordat je de gebruikersinterface vormgeeft
Het resultaatveld bevat de analyse en words_processed registreert het gebruik. Bewaar het onbewerkte antwoord in een afgeschermd testlogboek totdat je veldkoppeling zowel gewone als lege resultaten correct verwerkt.
Voorbeeldantwoord
{
"result": "Plagiarism analysis is returned here",
"words_processed": 8
}Integratiestappen
Begin met een kleine, traceerbare beoordelingslus
Een heldere integratie houdt de ingediende tekst, de analyse en de handeling van de beoordelaar met elkaar verbonden.
- 1
Doe een afgeschermde serveraanroep
Bewaar de API-sleutel als geheim en accepteer alleen tekst van gebruikers en systemen die je toepassing al heeft geautoriseerd.
- 2
Dien realistische documenten in
Bewaar een unieke Idempotency-Key en test vervolgens realistische essays, artikelen, lijsten en materiaal met en zonder citaten. Gebruik de sleutel alleen opnieuw voor een exacte nieuwe poging.
- 3
Bouw de beoordelingsstatus op
Toon voldoende context over de bron en passage, zodat iemand de overeenkomst kan beoordelen voordat die wordt gemarkeerd, afgewezen of geëscaleerd.
Geschikte toepassingen
Ontworpen voor wachtrijen waar originaliteit er al toe doet
De API hoort naast het document en de versiegeschiedenis te staan. Zo kun je een overeenkomst onderzoeken zonder van één percentage een eindoordeel te maken.
Een overeenkomst heeft context nodig
Geciteerde tekst, referenties, standaardzinnen en gelicentieerd materiaal kunnen allemaal voor overlap zorgen. Bekijk wat overeenkomt en waarom voordat je actie onderneemt.
Beoordeling van de opdracht
Plaats het resultaat in hetzelfde scherm als de inzending, bronvermeldingen, beoordelingsrubriek en aantekeningen van de docent.
Redactionele intake
Controleer aangeleverd werk vóór publicatie en stuur relevante overeenkomsten naar een redacteur voor broncontrole.
Catalogusinhoud
Controleer herhaalde product- of marktplaatsbeschrijvingen voordat ze aan een grote catalogus worden toegevoegd.
Interne kwaliteitscontroles
Stuur geautoriseerde tekst via een afgeschermde backend en houd de sleutel buiten de browserinterface.
Veelgestelde vragen over de API
Praktische antwoorden voor je live gaat
Begin met een serververzoek, leg de structuur van het antwoord vast en voeg het resultaat daarna toe aan je bestaande beoordelingsproces.
Welk endpoint gebruikt de Plagiaatchecker-API?+
Stuur een POST-verzoek naar https://api.detecting-ai.com/api/plagiarism/. De hoofdtekst van JSON heeft een verplicht tekstveld; verzend X-API-Key en houd een stabiele Idempotency-Key aan, zodat nieuwe pogingen kunnen worden hersteld.
Wat houdt een succesvol antwoord in?+
Het antwoord bevat het plagiaatresultaat en words_processed. Inspecteer het resultaat in een testomgeving voordat je het in je eigen rapportinterface in kaart brengt.
Betekent een match automatisch plagiaat?+
Nee. Overeenkomende tekst kan een citaat, gelicentieerd materiaal, een gangbare formulering of een onderdeel van een literatuurlijst zijn. Je workflow moet een beoordelaar de bron en context laten controleren.
Moet de API-sleutel vanuit de browser worden verzonden?+
Nee. Bewaar de sleutel in een vertrouwde serveromgeving en roep vanaf daar het endpoint voor plagiaatcontrole aan. Een browserbundel of openbare repository kan een persoonlijke sleutel niet beschermen.
Hoe wordt plagiaatgebruik geteld?+
Het gebruik is gebaseerd op het aantal ingevoerde woorden en wordt afgetrokken van de limiet voor plagiaatcontrole binnen het API-abonnement. Geslaagde antwoorden bevatten words_processed.
Bouw het eerste verzoek
Test de API met geciteerde en niet-geciteerde voorbeelden
Een bruikbare testset bevat originele tekst, veelgebruikte zinnen, citaten en een bewust gekopieerde passage. Zo kan je team passende beoordelingsstatussen ontwerpen.