API Integration Overview
Introduction
Integration with Sumatra is through a developer-friendly API. SDKs are available for most common frameworks.
API
The Sumatra API is a REST interface that accepts JSON events sent from your application and returns decisions
in real time (e.g. personalization choices, recommendations, and fraud decisions). In most cases, no pre-processing of the JSON events is needed because the data structure is highly flexible and is configured with customizable schema within Sumatra.
Try it
Try out the API for yourself in a few minutes! Sign up for a free sandbox to get an API key. Then use the curl command below to call the API from the command line. Be sure to replace SUMATRA_API_KEY
with your private key.
curl --request POST \
--url 'https://t6m7712cl6.execute-api.us-east-1.amazonaws.com/api/event?features' \
--header 'Content-Type: application/json' \
--header 'x-api-key: SUMATRA_API_KEY' \
--data '{
"_type": "my_event_type"
}'
Learn more in the API documentation.
SDKs & Integrations
SDKs that ease integration with the API are available for most common frameworks. Sumatra can also be added as a destination in Segment or Rudderstack.
Framework or data source | Type | Plan |
---|---|---|
Segment | Client | All plans |
Rudderstack | Client | All plans |
JavaScript Snippet | Client | All plans |
JavaScript NPM | Client | All plans |
Python | Server | All plans |
Node.js | Server | All plans |
Kafka | Message broker | Enterprise-only |
Kinesis | Message broker | Enterprise-only |