====== Jabber/XMPP API ======


===== Presence Access =====
Ähnlich wie bei Skype oder ICQ ist es bei tiggersWelt.net möglich über eine HTTP-Schnittstelle den Online-Status eines XMPP-Nutzers abzufragen. Voraussetzung hierfür ist:

  * Die XMPP-Domain ist bei tiggersWelt.net gehostet
  * Die Domain erlaubt Zugriff auf die Präsenz-Informationen
  * Der Benutzer hat den Zugriff nicht explizit blockiert

==== Dienst konfigurieren ====
Die Verfügbarkeit der API-Schnittstelle kann ganz einfach im [[:Kundeninterface]] verwaltet werden. Unter [[:Kundeninterface:Kommunikation]] -> [[:Kundeninterface:Jabber|XMPP]] in den [[:Kundeninterface:Jabber#generelle_einstellungen|Einstellungen der Domain]]

{{jabber:kif_xmpp_presence.png|}}

Die Option **Präsenz veröffentlichen** auf **Ja** stellen.

:!: Achtung: Ohne weiteres zutun wird die Präsenz-Information aller auf der jeweiligen Domain befindlichen Benutzer zu diesem Zeitpunkt veröffentlicht. Dies gilt grundsätzlich für System-Konten die auf dem Jabber/XMPP-Server verwendet werden. Virtuelle Jabber/XMPP-Benutzer können im Dialog Benutzer separat konfiguriert werden:

{{jabber:kif_xmpp_presence_vuser.png|}}

Die selbe Einstellung wie in den Domain-Einstellungen findet sich noch einmal in den Benutzer-Einstellungen wieder.

==== Dienst verwenden ====
Die Präsenz-Informationen werden unter der URL

  http://api.tiggerswelt.net/xmpp/status/<Jabber-ID>

veröffentlicht. Dabei gilt es die gewünschte Jabber-ID am Ende der Domain anzufügen, z.B.

  http://api.tiggerswelt.net/xmpp/status/support@tiggerswelt.net

==== Format der Ausgabe ====
Die API-Schnittstelle gibt Informationen über die Präsenz des jeweiligen Jabber-Nutzers als Presence-XML-Block konform zu [[http://tools.ietf.org/html/rfc6121#section-4.7|RFC-6121 4.7]] aus:

  <presence xmlns="jabber:client" from="support@tiggerswelt.net">
    <show>xa</show>
    <query xmlns="jabber:iq:last" seconds="8973"/>
  </presence>

Ist der abgefragte Benutzer offline, so enthält der <presence>-Tag das Attribut "type" = "unavailbale". Ist das Attribut nicht vorhanden ist der Benutzer eingelogged und online.

Ist der Benutzer "Away", "Extended Away", "Do not disturb" oder "Free for chat" wird das entsprechende <show>-Element beigefügt.

In Ergänzung zum RFC-Standard inkludiert die API-Schnittstelle noch das [[http://xmpp.org/extensions/xep-0256.html|XEP-0256 "Last Activity in presence"]].