Return JSON object that lists messages based on basic query filter parameters. Note: Use nextPageUrl and prevPageUrl from the response data for query pagination.

URL Parameters

NameDescriptionLocationRequiredDefault Value
spaceIdUnique identifier of the space.pathYes
refTimeUTC timestampqueryNo(current timestamp)
directionList messages 'before' or 'after' refTime.queryNoafter
sizeNumber of messages to return.queryNo30 (Max: 50)
pagerefReadonly. This parameter is not used by Spaces and is only a reference. i.e.: the value sent will be the same value returned.queryNo
nextRefObjIdMessageId of the next message.queryNo
prevRefObjIdMessageId of the previous message.queryNo

Body Parameters

None.

Authentication

JwtAuthenticator, Oauth2Authenticator, AnonymousAuthenticator

Authorization

PERM_TOPIC_READ

Example Request

URL

GET https://spacesapis.zang.io/api/spaces/{spaceId}/messages/byref

Headers

Authorization: "jwt eyJhbGciOiJSUzI1NiIsIdfgdfgnR5cCI6IkpXVCJ9.eyJ1c2VyX2lkX3NpZyI6ImxPWHpxNzVzR3J3X0xwWEMyRGRMakhyYXJlWVhyTzFMdEZHZkhkOWNkTXciLCJwcm9kdWN0X3R5cGUiOiJhY2NvdW50cyIsImxhc3R1cGRhdGV0aW1lIjoiMjAxNy0wMS0zMFQxMzo1ODo0Ny4yMDYiLCJpc3MiOiJ6YW5nLmlvIiwicHVibGlja2V5aWQiOiJhZ3h6Zm05dVpYTnVZVEl3TVRSeUdnc1NEVWRLZDNSUWRXSnNhV05MWlhrdfgdWdJQ2dsUEtFakFvTSIsImV4cCI6MTQ5NTM5MTIwMywidXNlcl9pZCI6ImFneHpmbTl1WlhOdVlUSXdNVFJ5RVFzU0JGVnpaWElZZ0lEQXMtX25fUW9NIiwidmVyIjoiMi4wIn0.SqZpw1uPIebqW3qlDsm0-DWYFKEH0SgPwtD-tSESWOF-5hLkZMqJH28ooWux2S7s9riIew7pTVPnZpTgJa5zHcEAG0gXSEJVOqmpGp_4ufM8YtZoZMpBFjyAkwyAt-ILkGUYIo0GU5WyzMPLV8YLXfgdfgOgkE2MGGOajBkjPmC2Db3pA0D0M9k-21EL1gwWBC5YIq0PDAkgulegwl6khRmB8irJQ-dfg-d-KV9eYfFpsCdJKRGzSfqg"

Or

Authorization: "bearer f746696f5de4528u128ae2f274eea253e8a7943a"

Example Response

{
  "data": [
    {
      "_id": "58ed325779bf9c47479faf9b",
      "category": "chat",
      "topicId": "58c97998d56ed915c3d28e32",
      "modified": "2017-04-11T19:46:40.867Z",
      "content": {
        "bodyText": "",
        "description": "",
        "data": [
          {
            "provider": "native",
            "providerFileType": "",
            "fileType": "document",
            "name": "Angularjs.docx",
            "fileId": "7de9fe09-2b4e-4a6d-9bfd-a3c8e78a7d59",
            "icon": "",
            "thumbnail": "",
            "keywords": "",
            "description": "",
            "previewFile": "",
            "fileSize": 238051,
            "thumbnailFile": "7de9fe09-2b4e-4a6d-9bfd-a3c8e78a7d59_convert/thumbnail.jpg",
            "metaData": {
              "stgeProvd": "gcs",
              "prvwProvd": "gcs",
              "paging": 0
            },
            "pages": 17,
            "nextSchedule": null,
            "convertStart": null,
            "convertStatus": 2,
            "convertError": "",
            "path": "https://storage.googleapis.com/onesnatesting/logan%2F7de9fe09-2b4e-4a6d-9bfd-a3c8e78a7d59?GoogleAccessId=logan-testing@onesnatesting.iam.gserviceaccount.com&Expires=1493401268&Signature=LlV4TqizeqYjWpmHyLumKa1YQU%2FmvYx9BwcCdxMlaE1Q4HH%2FRoJiwniZCvHnEpS7JkBlhSUxM%2BH9fPbFzw2Vnyfu94l8Zaf4YE%2BlsVZD7ujbXoYAUIU9G8LH4bdR9D5zhXfph3TmrJyWv9WYdVf%2FToLhd6XTAQeH5XMlZDThUjv1Z3rKJQxSxv04p%2BRTVuk4eX%2FnIEC33nTN2lNBTdehjU5xHM6qECbpHj6odw5tn%2B%2Ft3tazpd0LTOPyQ0DSFG2UbO1T8pqPpo3LZIjBf2%2BHFuCs04vAelfvwpOLApi1hjImZSoc1VSb9jhoyXTa0HKJcQnvM1FXt8tNGij6qvyzSQ%3D%3D&response-content-disposition=attachment%3B%20filename%3D%22Angularjs.docx%22",
            "previewUrl": "https://storage.googleapis.com/onesnatesting/logan%2F7de9fe09-2b4e-4a6d-9bfd-a3c8e78a7d59_convert%2Fthumbnail.jpg?GoogleAccessId=logan-testing@onesnatesting.iam.gserviceaccount.com&Expires=1493401268&Signature=W%2BRm8d8zVRMvNDqKaeEaOk56jUAB0Wec8xaXehB8a%2F%2BkzvOixskJCBuGL5VT4mHi%2FhlV5jniwqJEY7EH86g45gbmzOY2HbZ1Bx5LKOBNi72Pld%2FfWgco3L9ZpUczCofIsvf6RDvo2kVmlsO3A%2FmofN4yF7m9cbTlh%2B3C%2BTYyyeDqdqvcfkvBxu3A71eb1wt6Vq0rki8JFN49K5UwJDdvSymzHvxRUyJKWYXufpZKXqBhDlWRCBauUfotWE95HqrA9sF2%2F4EY6bjmsB9m8UcIjHiTMUxKrDlVrLD2q0ArOAFWrSU9dGD09AaNuf7zLOAPogOTxNr3qURTapWAMbagPg%3D%3D",
            "thumbnailUrl": "https://storage.googleapis.com/onesnatesting/logan%2F7de9fe09-2b4e-4a6d-9bfd-a3c8e78a7d59_convert%2Fthumbnail.jpg?GoogleAccessId=logan-testing@onesnatesting.iam.gserviceaccount.com&Expires=1493401268&Signature=W%2BRm8d8zVRMvNDqKaeEaOk56jUAB0Wec8xaXehB8a%2F%2BkzvOixskJCBuGL5VT4mHi%2FhlV5jniwqJEY7EH86g45gbmzOY2HbZ1Bx5LKOBNi72Pld%2FfWgco3L9ZpUczCofIsvf6RDvo2kVmlsO3A%2FmofN4yF7m9cbTlh%2B3C%2BTYyyeDqdqvcfkvBxu3A71eb1wt6Vq0rki8JFN49K5UwJDdvSymzHvxRUyJKWYXufpZKXqBhDlWRCBauUfotWE95HqrA9sF2%2F4EY6bjmsB9m8UcIjHiTMUxKrDlVrLD2q0ArOAFWrSU9dGD09AaNuf7zLOAPogOTxNr3qURTapWAMbagPg%3D%3D"
          }
        ],
        "assignees": []
      },
      "created": "2017-04-11T19:45:27.163Z",
      "sender": {
        "_id": "5846cc603bab0e18ff03cca0",
        "type": "user",
        "username": "ericd@esna.com",
        "displayname": "ericd ding",
        "picture_url": "https://storage.googleapis.com/onesnatesting/pictures/pfpic_ericd_977ffaaf-6b90-4e08-acde-06c66955bef0"
      },
      "likeCount": 0,
      "chatCount": 0,
      "__v": 0
    }
  ],
  "nextPageUrl": "/api/spaces/58c97998d56ed915c3d28e32/messages/query?refTime=&direction=after&size=1&pageref=2&begObjectId=&category=&parentmsg_category=&file_only=&chatmsg_only=&searchstring=&nextRefObjId=58ed325779bf9c47479faf9b",
  "previousPageUrl": "",
  "total": 1
}