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 (KIF) verwaltet werden. Unter KommunikationXMPP in den Einstellungen der Domain

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:

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 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 XEP-0256 "Last Activity in presence".

 
jabber/api.txt · Zuletzt geändert: 31.05.2011 17:22 von bernd
 
Impressum Letzte Änderungen per RSS-Feed Basiert auf DokuWiki tiggersWelt.net Internet Service Provider