Text senden, Ergebnis erhalten
Der REST-Vertrag benötigt nur ein Textfeld. Dadurch lässt er sich unkompliziert in einen bestehenden Abgabe- oder Redaktionsablauf einfügen.
REST-API / Plagiatsanalyse
API zur Plagiatsprüfung für Prüfungen mit Quellenbezug
Ergänzen Sie ein Schreib-, Bildungs- oder Verlagsprodukt um Plagiatsanalysen, ohne dass Prüfende zu einem getrennten Werkzeug wechseln müssen. Übermitteln Sie den Text von Ihrem Server und bringen Sie das Ergebnis in den bereits verwendeten Ablauf zurück.
Verwenden Sie den Schlüssel in einer privaten Serverumgebung.
cURL-Anfrage
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-Anfragen an /api/plagiarism/
02
Authentifizierung mit X-API-Key
03
Clientseitiger Idempotency-Key für sicher wiederholbare Anfragen
04
Ein erforderliches Textfeld
05
Separates Wortguthaben für diese Funktion
Die Quelle im Blick behalten
Ähnlichkeit hilft, wenn Prüfende ihre Ursache nachvollziehen können
Die API liefert Ihrem Produkt ein Plagiatsergebnis und Nutzungsdaten. Ihre Oberfläche sollte dieses Ergebnis mit der eingereichten Passage, verfügbarem Quellenkontext und den für die Prüfung maßgeblichen Regeln verbinden.
Standardmäßig serverseitig
Halten Sie den API-Schlüssel aus dem Browser heraus und geben Sie nur Berichtsdaten zurück, die Ihre Anwendung erklären kann.
Vor Maßnahmen prüfen
Behandeln Sie Überschneidungen als Hinweis für eine Quellenprüfung. Zitat, Erlaubnis und Richtlinie bestimmen weiterhin, was eine Übereinstimmung bedeutet.
Anfragevertrag
Der Anfragekörper hat eine klare Aufgabe
Senden Sie den vollständigen zu prüfenden Text als JSON-Zeichenfolge. Dokumentverarbeitung, Zugriffskontrolle und Metadaten zur Einreichung verwalten Sie in Ihrer eigenen Anwendung.
| Feld | Typ | Erforderlich | Funktion |
|---|---|---|---|
| text | string | Ja | Der Text, den der Plagiatsdienst analysieren soll. |
Prüfen Sie das Ergebnis, bevor Sie die Oberfläche gestalten
Das Feld result enthält die Analyse, words_processed erfasst die Nutzung. Bewahren Sie die Rohantwort in einem privaten Testprotokoll auf, bis Ihre Zuordnung sowohl Ergebnisse mit Treffern als auch leere Befunde korrekt behandelt.
Beispielantwort
{
"result": "Plagiarism analysis is returned here",
"words_processed": 8
}Integrationsablauf
Mit einer kleinen, nachvollziehbaren Prüfschleife beginnen
Eine klare Integration hält eingereichten Text, Analyse und Handlung des Prüfers miteinander verbunden.
- 1
Einen privaten Serveraufruf einrichten
Speichern Sie den API-Schlüssel als Geheimnis und nehmen Sie Text nur von Benutzern und Systemen an, die Ihre Anwendung bereits autorisiert.
- 2
Realistische Dokumente einreichen
Speichern Sie einen eindeutigen Idempotency-Key und testen Sie dann realistische Aufsätze, Artikel, Angebote sowie zitierte oder belegte Inhalte. Verwenden Sie den Schlüssel nur für die identische Wiederholung einer Anfrage.
- 3
Den Prüfstatus gestalten
Zeigen Sie genug Quellen- und Passagenkontext, damit ein Mensch eine Übereinstimmung versteht, bevor sie markiert, abgelehnt oder eskaliert wird.
Geeignete Einsätze
Für Warteschlangen, in denen Eigenständigkeit bereits zählt
Die API gehört neben das Dokument und seinen Verlauf. So lässt sich eine Übereinstimmung leichter untersuchen, ohne einen Prozentwert zum endgültigen Urteil zu machen.
Eine Übereinstimmung braucht Kontext
Zitate, Quellenangaben, Standardformulierungen und lizenzierte Inhalte können Überschneidungen erzeugen. Prüfen Sie vor einer Maßnahme, was übereinstimmt und warum.
Prüfung von Aufgaben
Zeigen Sie ein Plagiatsergebnis auf demselben Bildschirm wie Einreichung, Quellenangaben, Bewertungsraster und Anmerkungen der Lehrkraft.
Redaktionelle Eingangsprüfung
Prüfen Sie eingereichte Arbeiten vor der Veröffentlichung und leiten Sie relevante Überschneidungen zur Quellenprüfung an die Redaktion weiter.
Kataloginhalte
Prüfen Sie wiederholte Produkt- oder Marktplatzbeschreibungen, bevor sie einem großen Katalog hinzugefügt werden.
Interne Qualitätskontrollen
Leiten Sie autorisierten Text durch ein privates Backend und halten Sie den Schlüssel von der Browseroberfläche getrennt.
API-FAQ
Praktische Antworten vor dem Produktivstart
Beginnen Sie mit einer serverseitigen Anfrage, protokollieren Sie die Antwortstruktur und fügen Sie das Ergebnis dann Ihrem bestehenden Prüfablauf hinzu.
Welchen Endpunkt verwendet die API zur Plagiatsprüfung?+
Senden Sie eine POST-Anfrage an https://api.detecting-ai.com/api/plagiarism/. Der JSON-Körper enthält das erforderliche Feld text. Senden Sie X-API-Key und speichern Sie einen stabilen Idempotency-Key, damit Sie fehlgeschlagene Versuche sicher wiederholen können.
Was enthält eine erfolgreiche Antwort?+
Die Antwort enthält das Plagiatsergebnis und words_processed. Prüfen Sie das Ergebnis in einer Testumgebung, bevor Sie es Ihrer eigenen Berichtsoberfläche zuordnen.
Bedeutet eine Übereinstimmung automatisch ein Plagiat?+
Nein. Übereinstimmende Sprache kann zitiert, lizenziert, üblich, richtig belegt oder Teil eines Literaturverzeichnisses sein. Ihr Ablauf sollte die Prüfung von Quelle und Kontext ermöglichen.
Sollte der API-Schlüssel vom Browser gesendet werden?+
Nein. Bewahren Sie den Schlüssel in einer vertrauenswürdigen Serverumgebung auf und rufen Sie von dort den Plagiatsendpunkt auf. Ein Browser-Bundle oder öffentliches Repository kann einen privaten Schlüssel nicht schützen.
Wie wird die Nutzung der Plagiatsprüfung gezählt?+
Die Nutzung richtet sich nach der Wortzahl der Eingabe und wird vom Plagiatsguthaben des API-Abonnements abgezogen. Erfolgreiche Antworten enthalten words_processed.
Erste Anfrage erstellen
Testen Sie die API mit belegten und unbelegten Beispielen
Ein sinnvoller Test umfasst eigenständigen Text, häufige Wendungen, Zitate und eine bekannte kopierte Passage, damit Ihr Team passende Prüfstatus gestalten kann.