Publish via HTTP
AWS AppSync Events allows you to publish events via your API’s HTTP endpoint using a POST operation. Publishing is the only supported action over the endpoint.
Publish steps
Send a POST request to the address: https://HTTP_DOMAIN/event.
Add the authorization header(s) required to authorize your request.
Specify the following in the request body:
The channel that you are publishing to.
The list of events you are publishing. You can publish up to 5 events in a batch.
Each specified event in your publish request must be a stringified valid JSON value.
Publish example
The following is an example of a request.
{ "method": "POST", "headers": { "content-type": "application/json", "x-api-key": "da2-your-api-key" }, "body": { "channel": "default/channel", "events": [ "{\"event_1\":\"data_1\"}", "{\"event_2\":\"data_2\"}" ] } }
You can use your Browser’s fetch API
to publish the events. The following example demonstrates this.
await fetch(`https://${HTTP_DOMAIN}/event`, { "method": "POST", "headers": { "content-type": "application/json", "x-api-key": "da2-your-api-key" }, "body": { "channel": "default/channel", "events": [ "{\"event_1\":\"data_1\"}", "{\"event_2\":\"data_2\"}" ] } })
To learn more about the different authorization types that AWS AppSync Events supports, see Configuring authorization and authentication to secure Event APIs.