Lookup

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://api.app.net/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

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/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://api.app.net/channels/messages Any

Query String Parameters

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

Example

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/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://api.app.net/users/me/messages User public_messages or messages

Example

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/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"
  }
}