Plagiatsprüfung API - Integration von PlagAware in Ihre Applikation

Die wollen professionelle Plagiatsprüfung aus Ihrer eigenen App anbieten? Die PlagAware Plagiatsprüfung API lässt sich kinderleicht in Ihre bestehenden Systeme einbinden. In nur wenigen Minuten sind Sie startklar!

Starten Sie Plagiatsprüfungen direkt aus Ihrer Anwendung

Die PlagAware Plagiatsprüfung API erlaubt es Ihnen, Plagiatsprüfungen direkt aus Ihrer eigenen Website oder Ihrer eigenen Applikation zu beauftragen - ohne Ihre Website oder Applikation zu verlassen und die PlagAware Website aufrufen zu müssen. Auf diese Weise kann die professionelle Plagiatsprüfung von PlagAware nahtlos in Ihren individuellen Arbeitsablauf integriert werden.

Die Anwendungsfälle sind breit gefächert:

  • check_circle Prüfung von Artikeln vor der Veröffentlichung auf Urheberrechtsverletzungen
  • check_circle Automatische Prüfung von erworbenen Texten auf Einzigartigkeit
  • check_circle Integration von Plagiatsprüfungen in schulische Lern-Plattformen wie Moodle
  • check_circle Durchführung von Plagiatssuchen aus Kollaborations-Plattformen wie SharePoint
  • check_circle Vermeidung von Duplicate Content in Content Management Systemen wir Joomla, WordPress oder Blogger
  • check_circle Für viele Systeme wie Moodle und Joomla existieren bereits Integrationen zur Plagiatsprüfung oder sind in Vorbereitung.
  • check_circle Gerne unterstützen wir Sie dabei, die PlagAware Plagiatssuche auch in Ihr System zu integrieren.

Aufbau der PlagAware Plagiatsprüfung API

Die Übergabe erfolgt durch den Aufruf dieser Übergabe-Url (https://www.plagaware.com/de/service/api) und die Übergabe der unten definierten Parameter via HTTP-POST. Dabei geben Sie eine Rückgabe-Url an, die nach Beendigung der Plagiatsprüfung von PlagAware aufgerufen wird. In diese Url können Sie eigene Parameter einfügen, um etwa übergebene Texte mit einer eigenen Id oder weiteren Parametern zu kennzeichnen. Eine Beispiel-Implementation zum Aufruf der PlagAware-Schnittstelle auf PHP finden Sie weiter unten.

Übergabeparameter

Die zu übergebenden Parameter entsprechen denen der manuellen Übergabe. Falls Sie nur die übergebenen Daten prüfen, aber keine Plagiatsprüfung veranlassen wollen, aktivieren Sie bitte die Option "Dry Run". In diesem Fall wird Ihre Result-Url mit einem zufälligen Ergebniswert aufgerufen.

Parameter Typ Notwendig Beschreibung
UserCode String Ja Dieser Code identifiziert den PlagAware Benutzer, über den die Plagiatsprüfung durchgeführt werden soll. Falls Sie noch keinen keinen UserCode besitzen, können Sie ihn weiter unten nach erfolgter Anmeldung bei PlagAware erstellen lassen.
TestText String Alternativ Übergabe des zu prüfenden Texts. Der Text muss eine Mindestlänge von 250 Zeichen besitzen, ansonsten wird die Prüfung abgelehnt. Dieser Parameter muss nicht übergeben werden, wenn eine Textdatei in einem unterstützten Dateiformat übergeben wird.
ResultUrl String Nein Geben Sie hier optional eine URL Ihres Webauftritts an, die nach durchgeführter Plagiatsprüfung aufgerufen werden soll. Sie können die URL bereits mit eigenen URL-codierten Parametern übergeben, beispielsweise um eigene IDs zu vergeben. Nach erfolgter Prüfung wird dieser URL das Prüfergebnis in Prozent angehängt.
ReportName String Nein Optionaler Name der Plagiatsprüfung. Falls dieser Parameter nicht übergeben wird, wird der Name der Prüfung aus dem TestText bzw. aus dem Dateinamen des Textdokuments erzeugt.
ReportComment String Nein Optionaler Kommentar zur Plagiatsprüfung. Dieser Kommentar wird bei der Erstellung der Prüfung im Bericht angeführt.
ProjectId Integer Nein Optionale Id des Projekts, für das die Plagiatsprüfung durchgeführt werden soll. Wird dieses Feld nicht übergeben, wird die Prüfung ohne Bezug zu einem Projekt erstellt.
DryRun Boolean 0/1 Nein Wird die Option DryRun gesetzt, wird keine Plagiatsprüfung beauftragt. Stattdessen werden alle Parameter geprüft und die ResultUrl mit einem zufälligen Ergebniswert zwischen 0% und 100% aufgerufen.
Lang String Nein Wahl der Sprache des PDF-Berichts der Plagiatsprüfung. Zur Auswahl stehen momentan de und en für Deutsch bzw. Englisch.

Rückgabewerte

Falls der Text erfolgreich an PlagAware übermittelt wurde, wird dies mit Success: Text submitted zurückgemeldet. Ansonsten wird eine entsprechende Fehlermeldung ausgegeben.

Nach Abschluss der Plagiatsprüfung wird Ihre Result-Url mit den angehängten Parametern result und status aufgerufen. Dabei steht result für den Prozentsatz kopierter Worte des geprüften Texts. der Parameter result nimmt die Werte ok bzw. error an. In Ihrem Benutzerbereich können Sie die generierten Reports im Detail bewerten.

Ihr persönlicher UserCode

Um Ihren UserCode zu erzeugen oder anzuzeigen, melden Sie sich bitte bei PlagAware an.

Testformular

Bitte benutzen Sie das nachfolgende Formular, um erste Tests mit der PlagAware Plagiatsprüfung API durchzuführen. Die hierdurch angeforderten Prüfberichte können Sie wie gewohnt in Ihrem Benutzerbereich einsehen und bearbeiten.

User Code (mandatory)
Result Url (mandatory)
Text to Test (mandatory, > 250 chars)
Report Name (optional)
Report Comment (optional)
Project Id (optional)
Hold (optional) Datei hochladen und testen, aber Plagiatsprüfung nicht starten
Dry Run (Testmodus) Die Parameter werden geprüft und es wird Ihre Result-Url mit einem zufälligen Testergebnis aufgerufen.

Codebeispiel zum Aufruf der PlagAware API (PHP)

function SubmitPlagAwareTestText( $userCode, $resultUrl, $testText, $testFile, $reportName, $reportComment, $lang, $author, $projectId, $externalId, $libraryOnly, $copyToLibrary, $hold, $dryRun ) { $url = 'https://www.plagaware.com/service/api'; $boundary = "---------------------" . substr(md5(rand(0, 32000)), 0, 10); $header = "Content-Type: multipart/form-data; boundary=" . $boundary; $content = ""; // Collect FORM data $postdata = array( 'UserCode' => $userCode, 'ResultUrl' => $resultUrl, 'TestText' => $testText, 'ReportName' => $reportName, 'ReportComment' => $reportComment, 'ProjectId' => $projectId, 'Lang' => $lang, 'Author' => $author, 'ExternalId' => $externalId, 'Hold' => $hold, 'DryRun' => $dryRun, 'CopyToLibrary' => $copyToLibrary, 'LibraryOnly' => $libraryOnly ); foreach ($postdata as $key => $val) { $content .= "--$boundary\n"; $content .= "Content-Disposition: form-data; name=\"" . $key . "\"\n\n" . $val . "\n"; } $content .= "--$boundary\n"; // Collect FILE data $file_contents = file_get_contents($testFile); $filedata = array("TestFile", basename($testFile), $file_contents); $content .= "Content-Disposition: form-data; name=\"{$filedata[0]}\"; filename=\"{$filedata[1]}\"\n"; $content .= "Content-Transfer-Encoding: binary\n\n"; $content .= $filedata[2] . "\n"; $content .= "--$boundary--\n"; //Create stream context $context = stream_context_create(array( 'http' => array( 'method' => 'POST', 'header' => $header, 'content' => $content ) )); //Invoke API $result = file_get_contents($url, false, $context); return $result; }

Damit Ihre Daten sicher sind: Datenschutz nach DSGVO - Verschlüsselte Datenübertragung - Serverstandort in Deutschland

  • verschlüsselte Datenübertragung
  • Zahlung der Plagiatsprüfung per PayPal
  • Zahlung der Plagiatsprüfung per Sofortüberweisung
  • Zahlung der Plagiatsprüfung per Sofortüberweisung