Lookup

• Retrieve a Message
• Retrieve multiple Messages
• Retrieve my Messages

Retrieve a Message

Returns a specific Message.

You can always retrieve a message you created even if you are no longer able to view the rest of the Channel anymore.

This endpoint responds to general Message parameters.

Endpoint

Method	URL	Token
GET	https://alpha-api.app.net/stream/0/channels/{channel_id}/messages/{message_id}	Any

URL Parameters

Name	Description
channel_id	The id of the Channel containing the Message.
message_id	The id of the Message to retrieve.

Example

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://alpha-api.app.net/stream/0/channels/1/messages/1"

{
  "data": {
    "channel_id": "1",
    "created_at": "2012-12-11T00:31:49Z",
    "entities": {
      "hashtags": [

      ],
      "links": [

      ],
      "mentions": [

      ]
    },
    "html": "<span itemscope=\"https://app.net/schemas/Post\">Hello channel!</span>",
    "id": "1",
    "machine_only": false,
    "num_replies": 0,
    "source": {
      "client_id": "UxUWrSdVLyCaShN62xZR5tknGvAxK93P",
      "link": "https://app.net",
      "name": "Test app"
    },
    "text": "Hello channel!",
    "thread_id": "1",
    "user": "...user object..."
  },
  "meta": {
    "code": 200
  }
}

Retrieve multiple Messages

Returns multiple Messages requested by id. At most 200 messages can be requested. Messages may be requested from more than one channel at a time. Messages which do not exist or which the requesting user does not have authorization to view will not be returned.

This endpoint responds to general Message parameters.

Endpoint

Method	URL	Token
GET	https://alpha-api.app.net/stream/0/channels/messages	Any

Query String Parameters

Name	Description
ids	A comma separated list of ids of the Messages to retrieve.

Example

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://alpha-api.app.net/stream/0/channels/messages?ids=1,2"

{
  "data": [
    {
      "channel_id": "1",
      "created_at": "2012-12-11T00:31:49Z",
      "entities": {
        "hashtags": [

        ],
        "links": [

        ],
        "mentions": [

        ]
      },
      "html": "<span itemscope=\"https://app.net/schemas/Post\">Hello channel!</span>",
      "id": "1",
      "machine_only": false,
      "num_replies": 0,
      "source": {
        "client_id": "UxUWrSdVLyCaShN62xZR5tknGvAxK93P",
        "link": "https://app.net",
        "name": "Test app"
      },
      "text": "Hello channel!",
      "thread_id": "1",
      "user": "...user object..."
    }
  ],
  "meta": {
    "code": 200
  }
}

Retrieve my Messages

Retrieve a stream of the Messages the current user has created.

This endpoint responds to general Message parameters.

Responses from this endpoint are paginated.

Endpoint

Method	URL	Token	Scope
GET	https://alpha-api.app.net/stream/0/users/me/messages	User	public_messages or messages

Example

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://alpha-api.app.net/stream/0/users/me/messages"

{
  "data": [
    {
      "channel_id": "1",
      "created_at": "2012-12-11T00:31:49Z",
      "entities": {
        "hashtags": [

        ],
        "links": [

        ],
        "mentions": [

        ]
      },
      "html": "<span itemscope=\"https://app.net/schemas/Post\">Hello channel!</span>",
      "id": "1",
      "machine_only": false,
      "num_replies": 0,
      "source": {
        "client_id": "UxUWrSdVLyCaShN62xZR5tknGvAxK93P",
        "link": "https://app.net",
        "name": "Test app"
      },
      "text": "Hello channel!",
      "thread_id": "1",
      "user": "...user object...",
      "pagination_id": "1"
    }
  ],
  "meta": {
    "code": 200,
    "more": false,
    "min_id": "1",
    "max_id": "1"
  }
}