iZ-smart.net API v2

Wir bieten seit Mai 2011 ein neues API an was detaillierte Informationen zu eurem Channel bzw. Nicknamen liefert. Im wesentlichen bietet auch diese Version Chaninfo und Nickinfo. Jedoch nicht mehr in den altbekannten Plain-Text Formaten (wie zum Beispiel aus Chaninfo) sondern JSON (bzw. JSONP) und XML in beiden Modulen. Als Datenlieferant dient bedient sich auch dieses API an SakIs (Swiss Army Knife IRC Services) – unserem selbst geschriebenen IRC Service, der sich in der Vergangenheit als extrem zuverlässiger und stabiler Datenlieferant bewährt hat.

Zugriff:

Basis-URL für Zugriffe ist: http://wwwapi.iZ-smart.net/2/

Zugriffe selbst sind per HTTP GET möglich.

Generelles:

Zu Channeln die die Modes +p, +s gesetzt haben werden im API keine Informationen ausgegeben. Für Channel die Modes +k, +i, und +u gesetzt haben werden keine Nutzer im Channel ausgegeben. Für Nutzer die Usermode +p gesetzt haben werden ebenfalls keine Channel ausgegeben. Die gezeigten Informationen belaufen sich nur auf Daten die jeder Nutzer des Netzwerkes ebenfalls erlangen könnte indem dem Channel gejoined wird bzw. ein /WHOIS auf einen Nutzer ausgeführt wird.

Formate:

Für die Module Chaninfo und Nickinfo sind die Formate JSON und XML verfügbar. Wird der Parameter format bei Nickinfo oder Chaninfo weggelassen antwortet unser API per Definition im Format JSON. Dies ist insbesondere für JavaScript Cross-Domain-Requests sinnvoll. Ein unmittelbares Weiterverarbeiten ist mit dem Parameter jsoncallback möglich (z.B. http://wwwapi.iZ-smart.net/2/nickinfo/hexa/json/?jsoncallback=doit – hier würde das JSON-Objekt an die Funktion doit übergeben in der die Daten dann weiterverarbeitet werden können). Das Modul Webchat liefert nur JavaScript aus.

Für Nickinfo bieten wir zusätzlich png zur Online/Offline-Anzeige, dot als einfachen Punkt (ebenfalls zur Online/Offline Anzeige) sowie vcard für die alt bekannte vCard.

Module

Chaninfo · Nickinfo · Webchat