Getting Started
Setting Up
In order to set up your account, we need a few things:
- Create a user on Redshift. You need to create an account for Ironsource.atom in your Redshift cluster, and send us the details so we will be able to connect: user, password, url, dbname.
- Add our IPs to your security group. We will ask you to add some IP’s to your Redshift Security group and we are good to go.
- Grant us access to an S3 bucket. Provide us with an Access Key and a Secret Access Key with full access permissions to an S3 bucket.
- Create your Ironsource.atom account.
Sending Data to Ironsource.atom via http
We support single and batch events POST or GET requests.
Single Event POST Example
POST to http://track.atom-data.io
{
"table": "cluster.schema.table_name",
"data": "{\"name\": \"iron\", \"last_name\": \"source\"}",
"auth": "THE SHA256 of the data using a pre-shared key"
}
Bulk event POST
The value of ‘data’ should be a stringified array and you should add ‘bulk’: true.
POST to http://track.atom-data.io/bulk
{
"table": "cluster.schema.table_name",
"data": "[\"{\"name\": \"iron\", \"last_name\": \"source\"}\"
,\"{\"name\": \"iron2\", \"last_name\": \"source2\"}\"]",
"auth": "THE SHA256 of the data using a pre-shared key",
"bulk": true
}
Single Event GET
GET track.atom-data.io?data=eyJ0YWJsZSI6Imluc3RhbGxjb3JlI=
where eyJ0YWJsZSI6Imluc3RhbGxjb3JlI= is base64 encoded stringified JSON (or stringified array of jsons).
HTTP Response Codes
200 | OK |
400 | Invalid JSON / No data / Missing data or table |
401 | Auth Error |