GET chan_name/v1/subscribe/dur_name

The web method GET chan_name/v1/subscribe/dur_name gets zero or more messages from a specific durable subscription on a specific channel.

  • chan_name in the URI is the channel name.
  • dur_name in the URI is the durable name of the subscription.

One common usage pattern would be to repeat this request until the response array is empty, indicating that no messages remain in the durable.

HTTP Parameters

Syntax Description
timeout=wait_time Optional.

When present, the request waits this interval (in seconds) for messages to become available. If the value is less than 1, the request waits the minimum time, one second.

When absent, the request waits the default interval.

matcher=json_content_matcher Required for last-value durables.

Specify a content matcher that includes the key field of a last-value durable.

Example Requests

curl http://host:port/chan_name/v1/subscribe/dur_name?timeout=10
curl http://host:port/chan_name/v1/subscribe/lv_dur_name?matcher='\{"symbol":"amzn"\}'

Example Response

{
  "messages":[
    {
      "symbol":"amzn",
      "bid":1732
    }
  ]
}

Subscribing on EMS Channels

When subscribing on an EMS channel, you must supply the topic name in the matcher parameter of the request. For example: 
curl http://host:port/chan_name/v1/subscribe/lv_dur_name?matcher='\{"_dest":"symbol.amzn"\}'