Startseite | Dokumentation
BadWord-Check
Offizielle Dokumentation
Version: 1.0
Stand: Juli 2005
© schimpfwoerter.de 2005
Der BadwordCheck wird mittels "GET" oder "POST" auf ein PHP-File gesteuert. Als Parameter sind
Username,
Password, das zu überprüfende Wort, sowie der Abfragebereich anzugeben. Genaueres hierzu unter
"Bedienung des BadWord-Check". Der
BadwordCheck gibt dann Zahlencodes zurück. Sie geben den Fehlercode
an. Beschreibung
der Fehlercodes finden Sie unter "Rückmeldungen des BadWord-Check".
Da es zwei völlig redundante BadwordChecks gibt, gibt es auch zwei Scripte zum
Ansteuern der einzelnen BadwordChecks. Ihre Adressen sind:
http://webservices.schimpfwoerter.de/badwordcheck1.php
http://webservices.schimpfwoerter.de/badwordcheck2.php
Die einzelnen BadwordChecks-Abfragen sind jeweils auf maximale Ausfallsicherheit konzipiert. In aller Regel
reicht es eine BadwordCheck-URL zu benutzen. Beide BadwordCheck-Abfragen unterscheiden sich nicht,
weder von der Bedienung noch von den Rückmeldungen.
Das BadwordCheck ist im Moment NUR zur Abfrage eines "bösen Wortes" auch "Badword"
der deutschen Sprache genannt konzipiert. BadwordChecks zur Abfrage von BadWords
aus anderen Sprachen werden in Kürze folgen.
Zum besseren Verständnis der Einbindung in ein bestehendes Formular haben wir ein Beispielscript zur Verfügung gestellt.
Das Script darf selbstverständlich auf Ihre Bedürfnisse angepasst werden, eine Weitergabe des Quelltexts an Dritte ist jedoch nicht gestattet!
Bitte ändern Sie vor der Benutzung noch Ihren Usernamen sowie Ihr Passwort im Script ab.
>>> Beispielscript
Das BadwordCheck kann mittels URL Get gesteuert werden. Die BadwordCheck-Script URLs lauten:
http://webservices.schimpfwoerter.de/badwordcheck1.php
http://webservices.schimpfwoerter.de/badwordcheck2.php
(Das sind die zwei redundanten BadwordChecks wie in "Funktion des BadwordChecks" beschrieben)
Das Post setzt sich folgendermaßen zusammen:
http://webservices.schimpfwoerter.de/badwordcheck1.php?
| Wert | Beschreibung |
|---|---|
| user= | Hier müssen Sie Ihren Usernamen eintragen, diesen bekommen Sie von uns mit der Begrüßungsmail mitgeteilt |
| pass= | Ihr Passwort, dieses wird Ihnen auch mit der Begrüßungsmail zugestellt. |
| search= | Hier wird der zu prüfende String gepostet. Die maximale Länge eines zu prüfendens Strings beträgt 5000 Zeichen. |
| range= | Hier geben Sie an, gegen welche Bereiche sie das Wort prüfen lassen möchten. (1=Nur Schimpfwörter, 2=Nur harmlosere Beleidigungen, Schimpfwörter und sog. Weicheier-Synonyme oder 3=Jegliche Art von Schimpfwörtern (beinhaltet die Option 1+2)) |
Beispiele:
Prüfen eines Schimpfwortes:
Sie wollen prüfen lassen, ob ein Wort ein Schimpfwort ist.
Das Schimpfwort lautet: "Arsch". Ihr Benutzername ist "testuser" Ihr Passwort
ist "testpass". Hierfür lautet der URL-Aufruf:
http://webservices.schimpfwoerter.de/badwordcheck1.php?user=testuser&pass=testpass&search=Arsch&range=1
Das BadwordCheck antwortet in einem Zahlencode. Der Zahlencode kann dann zur Auswertung des
Sendevorgangs verwendet werden.
Rückmeldungen:
| Code | Beschreibung |
|---|---|
| 100 | Systemfehler/Wartung |
| 101 | Username/Password falsch |
| 102 | Tageslimit erreicht |
| 103 | Konto gesperrt / Mangelndes Guthaben |
| 104 | Konto gesperrt / sonstige Gründe |
| 105 | Konto noch nicht freigeschaltet |
| 109 | Konto gelöscht |
| 200 | Wort vorhanden |
| 201 | Wort nicht vorhanden |
Verantwortlich für die Dokumentation und das BadwordCheck:
schimpfwoerter.de WebServices
Thorsten Scherwinske
Broichbachtal 30
52134 Herzogenrath
Deutschland
E-Mail: webservices@schimpfwoerter.de
Copyright by schimpfwoerter.de WebServices
Impressum & Nutzungsbedingungen