Read Datafeed 1

get
https://youragentURL.symphony.com/agent
/v4/datafeed/{id}/read
(Deprecated - Datafeed v1 will be fully replaced by the datafeed 2 service in the future. Please consider migrating over to datafeed 2 APIs /agent/v5/datafeeds/{id}/read. For more information on the timeline as well as on the benefits of datafeed 2, please reach out to your Technical Account Manager or to our developer documentation https://docs.developers.symphony.com/building-bots-on-symphony/datafeed) Read a given datafeed.

Read messages from the given datafeed. If no more messages are available then this method will block. It is intended that the client should re-call this method as soon as it has processed the messages received in the previous call. If the client is able to consume messages more quickly than they become available then each call will initially block, there is no need to delay before re-calling this method.

A datafeed will expire if its unread capacity is reached. A datafeed can only be consumed by one client thread at a time. E.g. polling the datafeed by two threads may lead to messages being delivered out of order.

Parameters
Path
id*
string
Datafeed ID
Query
limit
integer
Max No. of messages to return.
Header
sessionToken*
string
Session authentication token.
keyManagerToken*
string
Key Manager authentication token.
Responses
200: OK
List of messages that have occurred since last time this URL was polled. If the list is empty, it means the request has reached its timeout, and the client should poll again.
204: No Content
No Messages.
400: Bad Request
Client error, see response body for further details.
401: Unauthorized
Unauthorized: Session tokens invalid.
403: Forbidden
Forbidden: Caller lacks necessary entitlement.
500: Internal Server Error
Server error, see response body for further details.
Last modified 2mo ago