Technical integration

The Glass Data API is a REST API hosted at https://api.glassdata.io. Integration must be done exclusively via backend — credentials must not be exposed in public clients.

Authentication

Use Basic Auth with the key ID as the username and the secret key as the password. Credentials are generated in the platform panel.

To validate your key:

curl https://api.glassdata.io/account -u KEY_ID:KEY_SECRET

Expected response:

{"account":{"id":"0628fd01-038f-7000-9345-4aaefbe9c6b3"}}

Format

Requests with a body (POST, PATCH) must use Content-Type: application/json. Responses are also returned in JSON.

Errors

The API returns standard HTTP status codes. Errors include a message field with the problem description:

{"message":"invalid credentials"}
Code Meaning
400 Invalid request — check the payload
401 Missing or incorrect credentials
403 No permission for this resource
404 Resource not found
422 Valid data but rejected by platform logic
500 Internal error — contact support if it persists

Platform status

Availability and maintenance schedule at status.glassdata.io.

Getting started

  1. Generate an API key in the panel.
  2. Validate the key with the GET /account endpoint.
  3. Register at least one event type with the fields for your use case.
  4. Send occurrences to POST /events specifying the event type.
  5. Track the data in the panel under metrics and monitors.

To understand event modeling, see Event type and Event.