Publish with Headers¶
Message headers is a collection of name/value
pairs. A subscriber can set a filter expressed as an SQL "where clause" query (called selector) which Backendless uses to determine whether a message should be delivered to the subscriber. When the query matches the published data in message headers, message is delivered to the corresponding subscriber. For more information see the Conditional Delivery section of this guide.
The following example publishes a message with the city : Tokyo
header:
Request¶
Important
Make sure to replace xxxx in the domain name in the sample request below to the one assigned to your application.
curl -H Content-Type:application/json -X POST \
-d '{"message":"hello world!", "headers":{"city":"Tokyo"}}' \
-v https://xxxx.backendless.app/api/messaging/Default
Response¶
{
"errorMessage":null,
"messageId":"message:37C81F70-9B7B-4CF8-FF24-3690D9054F00",
"status":"scheduled"
}
The value of the messageId
property can be used to obtain the message delivery status.