ASI/channels/:channel_id/@subscriptions

GET ^top

Lists subscriptions.

Returns

  • 200 - OK

Response example


{
  "entry": {
    "group_subscribers": [

    ],
    "user_subscribers": [
      {
        "name": {
          "unstructured": "Essi Esimerkki",
          "family_name": "Esimerkki",
          "given_name": "Essi"
        },
        "address": {
          "unstructured": "Yrjö-Koskisenkatu 42, 00170 Helsinki",
          "postal_code": "00170",
          "street_address": "Yrjö-Koskisenkatu 42",
          "locality": "Helsinki"
        },
        "birthdate": "1940-06-01",
        "updated_at": "2011-09-28T11:11:07Z",
        "is_association": null,
        "username": "kusti6",
        "id": "cqx53O6Cir4juJeJfcaj6R",
        "avatar": {
          "link": {
            "href": "/people/cqx53O6Cir4juJeJfcaj6R/@avatar",
            "rel": "self"
          },
          "status": "not_set"
        },
        "gender": "MALE",
        "msn_nick": "maison",
        "phone_number": "+358 40 834 7176",
        "website": "http://example.com",
        "irc_nick": "pelle",
        "description": "About me",
        "status": {
          "changed": "2011-09-28T11:11:07Z",
          "message": "Valid person rocks."
        }
      }
    ]
  }
}

POST ^top

Subscribes to this channel. Post without parameters subscribes current user to the channel. Channel of type group can have only a single group subscriber and no user subscribers.

Public and friend channels can have only user subscribers.

Only group admins can subscribe the group to a channel.

The owner (or any existing subscriber) of a private channel can subscribe other users to the channel by passing the person_id parameter.

Parameters

group_id

The group to be subscribed

person_id

The user to subscribe to a private channel

Access

Application

Returns

  • 201 - Created

DELETE ^top

Remove subscriptions.

Single group can be unsubscribed by that group's admin.

Single users can be unsubscribed by friend and public channel admins.

If no parameters are given, unsubscribe current user.

Parameters

group_id

The group to be unsubscribed.

person_id

The person to be unsubscribed.

Returns

  • 200 - OK