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