ullWiki create API (german)
Über folgende API können Wiki-Einträge automatisiert/skriptgesteuert über einen HTTP GET Webaufruf erstellt werden.
Aufruf
Beispiel:
http://www.ullright.org/ullWiki/createApi?
fields[subject]=Mein Testeintrag&
fields[body]=
Überschrift
Hallo das ist ein Test
&fields[WriteGroups]=WikiAdmins,Group1
Grundsätzlich müssen alle Daten "url-encodiert" werden. (RFC 1738)
Z.B. mit der PHP-Funktion http://www.functions-online.com/rawurlencode.html
Diese Seite kann auch gleich zum Erstellen von url-encodierten Strings verwendet werden.
Liste aller verfügbaren Felder:
Feldname | Beispielinhalt | Bemerkung |
fields[ReadGroupsText] |
Wiki-Admins,Group1 |
Gruppennamen getrennt durch Komma "," url-encodiert |
fields[WriteGroupsText] |
Wiki-Admins,Group1 |
Gruppennamen getrennt durch Komma "," url-encodiert |
fields[body] |
ÜberschriftHallo das ist ein Test |
Pflichtfeld, url-encodiertes HTML |
fields[duplicate_tags_for_search | Tag1,Tag2 | Tags getrennt durch Komma "," url-encodiert |
fields[is_approved] | on | 'on' oder 'off', Standard ist 'on' |
fields[is_outdated] | off | 'on' oder 'off', Standard ist 'off' |
fields[subject] |
Mein Testeintrag |
Pflichtfeld, url-encodierter String |
Antwort
Gültig
Auf gültige Anfragen antwortet der Server mit HTTP Statuscode 200 und "Ok."
Fehlerhaft
Auf ungültige Anfragen antwortet der Server mit HTTP Statuscode 400 "Bad request" und informiert über die aufgetretenen Fehler in Text/HTML-Form.
Beispiel:
http://www.ullright.orgt/ullWiki/createApi?
fields[subject]=Mein Testeintrag&
Antwort:
Array ( [field_error] => Array ( [label] => Text [error] => Pflichtfeld [value] => ) )
Bedeutung: Das Feld Text (body) ist ein Pflichtfeld und muss angegeben werden.