# 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](/en/api/api-keys/). To validate an existing key:

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

Expected response:

```json
{"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:

```json
{"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](https://status.glassdata.io).

## Getting started

1. Generate an [API key](/en/api/api-keys/) 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](/en/events/event_types/) and [Event](/en/events/events/).