Automatisierte Übergabe von zu prüfenden Texten

Integration von PlagAware in Ihre Applikation

PlagAware bietet Ihnen die Möglichkeit, zu prüfende Texte automatisiert zu übergeben. Dadurch können Sie die Plagiatsprüfung von PlagAware in Ihre Anwendung zu integrieren, ohne die Weboberfläche von PlagAware aufrufen zu müssen.

Die Übergabe erfolgt durch den Aufruf dieser Übergabe-Url (http://www.plagaware.de/service/submittext) 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.

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 Schnittstelle durchzuführen. Die hierdurch angeforderten Prüfberichte können Sie wie gewohnt in Ihrem Benutzerbereich einsehen und bearbeiten.

Codebeispiel zum Aufruf der PlagAware-Schnittstelle (PHP)

function SubmitPlagAwareTestText($userCode, 
				$resultUrl, 
				$testText, 
				$reportName=null, 
				$reportComment=null, 
				$projectId=null, 
				$dryRun=false)  
{
     $host = "www.plagaware.de";
     $port = 80;
     $path = "/service/submittext";
     $postdata  = array('UserCode'=>$userCode, 
				'ResultUrl'=>$resultUrl, 
				'TestText'=>$testText,
				'ReportName'=>$reportName,
				'ReportComment'=>$reportComment,
				'ProjectId'=>$projectId,
				'DryRun'=>$dryRun);
     $data = "";
     $boundary = "---------------------".substr(md5(rand(0,32000)),0,10);
     $fp = fsockopen($host, $port);
     fputs($fp, "POST $path HTTP/1.0\n");
     fputs($fp, "Host: $host\n");
     fputs($fp, "Content-type: multipart/form-data; boundary=".$boundary."\n");
     foreach($postdata as $key => $val){
         $data .= "--$boundary\n";
         $data .= "Content-Disposition: form-data; name=\"".$key."\"\n\n".$val."\n";
     }
     $data .= "--$boundary\n";
     fputs($fp, "Content-length: ".strlen($data)."\n\n");
     fputs($fp, $data);
     while(!feof($fp)) {
         $res .= fread($fp, 1);
     }
     fclose($fp);
     return $res;
}