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]

Überschrift

Hallo 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.