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.
