# Integração técnica

A API da Glass Data é uma API REST hospedada em `https://api.glassdata.io`. A integração deve ser feita exclusivamente via backend — as credenciais não devem ser expostas em clientes públicos.

## Autenticação

A API usa HTTP Basic com credenciais geradas em [Chaves da API](/pt/api/api-keys/). Para validar uma chave já criada:

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

Resposta esperada:

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

## Formato

Requisições com corpo (`POST`, `PATCH`) devem usar `Content-Type: application/json`. As respostas também são retornadas em JSON.

## Erros

A API retorna códigos HTTP padrão. Erros incluem um campo `message` com a descrição do problema:

```json
{"message":"invalid credentials"}
```

| Código | Significado |
|--------|-------------|
| `400` | Requisição inválida — verifique o payload |
| `401` | Credenciais ausentes ou incorretas |
| `403` | Sem permissão para este recurso |
| `404` | Recurso não encontrado |
| `422` | Dados válidos mas rejeitados pela lógica da plataforma |
| `500` | Erro interno — entre em contato se persistir |

## Status da plataforma

Disponibilidade e agenda de manutenções em [status.glassdata.io](https://status.glassdata.io).

## Primeiros passos

1. Gere uma [chave de API](/pt/api/api-keys/) no painel.
2. Valide a chave com o endpoint `GET /account`.
3. Cadastre ao menos um tipo de evento com os campos do seu caso de uso.
4. Envie ocorrências para `POST /events` informando o `type` do evento.
5. Acompanhe os dados no painel em métricas e monitoramentos.

Para entender a modelagem de eventos, consulte [Tipo de evento](/pt/events/event_types/) e [Evento](/pt/events/events/).