Skip to main content

Iglu API

Iteratively fully supports the Iglu schema service APIs as defined in Iglu server. This means that an Iglu client can retrieve schemas referenced by all incoming self-describing JSON objects and use them to validate and shred incoming events.

To enable this in your Snowplow installation:

  1. Generate an API Token in your Iteratively account. This is the apikey that the Iglu client will use to authenticate itself to the Iteratively Iglu-compatible schema repository
    1. Browse to Settings, select the API Tokens page, and create a new token
  2. Add another repository to your Iglu configuration file (e.g. iglu.json in Snowplow Micro):
{
"name": "Amplitude",
"priority": 0,
"vendorPrefixes": [ "ly.iterative" ],
"connection": {
"http": {
"uri": "https://data-api.amplitude.com/iglu",
"apikey": "{your-api-key}"
}
}
}

To retrieve all schemas ever created in your tracking plan:

curl 'https://data-api.amplitude.com/iglu/schemas/{vendor-name}/' --header 'apikey: {your-api-key}'