[mitchatten]

Chanlist

URL

Die URL für den Zugriff auf Clanlist lautet:

https://api.relay-chat.de/2/chanlist/

Parameter

Der Parameter, der dieser URL übergeben wird, ist limit (siehe unten). Dieser limitiert die Anzahl der zurückgegebenen Channel. Das Ergebnis wird jeweils nach Anzahl der Nutzer sortiert zurückgegeben.

Der Parameter include_users gibt an, ob die Benutzer des Channels mit zurückgegeben werden sollen. Übergeben wird ein Boolean (true, false). Der Default ist false. Es werden die selben Kriterien zur Rückgabe der Benutzer verwendet wie auch im Chaninfo Modul.

Format

$ curl "https://api.relay-chat.de/2/chanlist/?limit=4&include_users=true" | jsonpretty
{
  "izsmart": {
    "ajax": false,
    "cache": true,
    "cache_hash": "7eb8c8-59699fd1cb9d",
    "cache_online": true,
    "mobile": false,
    "request_uri": "/chanlist/",
    "runtime": 0.11414,
    "time": 1397073144,
    "version": "tiberius/2.0.85@production"
  },
  "additional_info": {
    "total_count": 479,
    "limit": 4,
    "offset": 0
  },
  "chanlist_count": 4,
  "chanlist": [
    {
      "channel": "#iZ-smart",
      "registered": true,
      "topic": "Willkommen im Netzwerk-Channel #iZ-smart -- Be smart - It's smart ]-[ Fragen bitte im Channel stellen! ]-[ Bitte daran denken, dass wir hier im Help-Channel sind! ]-[ News: Änderungen am API v2: http://j.mp/1eKDjWe ]-[ iZ-smart bei Facebook: http://on.fb.me/izsmart ]",
      "topicsetby": "hexa",
      "topictime": 1389371676,
      "url": {
        "chaninfo": "/chaninfo/iZ-smart/json/",
        "stats": "http://insiderz.ircstuff.de/iz-smart"
      },
      "user_list": [
        {
          "nickname": "diskman",
          "status": 5,
          "status_clear": "Founder"
        },
        {
          "nickname": "hexa",
          "status": 5,
          "status_clear": "Founder"
        },
        {
          "nickname": "aerolife",
          "status": 5,
          "status_clear": "Founder"
        },
        { ... bunch more ... }
      ],
      "users": 79
    },
    {
      "channel": "#sos-radio",
      "registered": true,
      "topic": "\u0002\u00034SOS-RADIO:\u0003 \u000312NOW ONAIR:\u0003 dies oder das? wer weiß? Beat-Club oder PowerMix? Auf jeden fall etwas mit StacK! \u000312@\u0003\u0002 http://www.sos-radio.net \u0002\u00034 SENDEPLAN:\u0002\u0003 http://sendeplan.sos-radio.net \u0002\u00034 FORUM:\u0002\u0003 http://forum.sos-radio.net \u0002\u00034 TEAMSPEAK:\u0002\u0003 ts.sos-radio.net \u0002\u00034 STATS:\u0002\u0003 http://stats.sos-radio.net\u000f",
      "topicsetby": "SOS-Radio",
      "topictime": 1397070058,
      "url": {
        "chaninfo": "/chaninfo/sos-radio/json/",
        "stats": "http://insiderz.ircstuff.de/sos-radio"
      },
      "user_list": [
        {
          "nickname": "Sparrow",
          "status": 5,
          "status_clear": "Founder"
        },
        {
          "nickname": "Seelenjaegerin",
          "status": 5,
          "status_clear": "Founder"
        },
        { ... bunch more ... }
      ],
      "users": 77
    },
    {
      "channel": "#radio-thirty",
      "registered": true,
      "topic": "\u000311,0 * \u000312,11 * \u00030,12 * \u000311,2 *** www.radio-thirty.de *** \u000311,12 *** \u0002Oldies mit Tina-chan_onAir\u0002 *** \u000311,2 *** #radio-thirty \u000311,2*** SENDEPLAN: http://sendeplan.radio-thirty.de *** \u00030,12 * \u000312,11 * \u000311,0 * ",
      "topicsetby": "ThirtyBot",
      "topictime": 1397070593,
      "url": {
        "chaninfo": "/chaninfo/radio-thirty/json/",
        "stats": "http://insiderz.ircstuff.de/radio-thirty"
      },
      "user_list": [
        {
          "nickname": "lmichael",
          "status": 5,
          "status_clear": "Founder"
        },
        {
          "nickname": "huelle",
          "status": 4,
          "status_clear": "Admin"
        },
        { ... bunch more ... }
      ],
      "users": 42
    },
    {
      "channel": "#fernsehkritik-tv",
      "registered": true,
      "topic": "Willkommen bei den rechten linksgrünen antikommunistischen Meinungsfaschist*Innen von den Anonymen Anti-Meinenden*Innen! - Neue Folge da? -> http://bit.ly/1bCuLhL - Supergeil http://youtu.be/L41ToLKjl1c ",
      "topicsetby": "alderschwede",
      "topictime": 1396640962,
      "url": {
        "chaninfo": "/chaninfo/fernsehkritik-tv/json/",
        "stats": "http://insiderz.ircstuff.de/fernsehkritik-tv"
      },
      "user_list": [
        {
          "nickname": "Merbatur",
          "status": 5,
          "status_clear": "Founder"
        },
        {
          "nickname": "Hopperbot",
          "status": 4,
          "status_clear": "Admin"
        },
        { ... bunch more ... }
      ],
      "users": 40
    }
  ]
}

Payload

Anmerkung: Der Schlüssel chanlist.url.stats wird nur dann zurückgegeben sofern die Statistiken für diesen Channel tatsächlich aktiviert sind (sich also der Bot iZ-Stats im Channel befindet).