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

The API uses HTTP Basic with credentials generated in API keys. To validate an existing 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.