Integração técnica

A API da Glass Data é uma API REST hospedada em https://api.glassdata.io. Integre a API apenas pelo backend: não exponha as credenciais em clientes públicos.

Autenticação

A API usa HTTP Basic com credenciais geradas em Chaves da API. Para validar uma chave já criada:

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

Resposta esperada:

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

Formato

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

Erros

A API retorna códigos HTTP padrão. Um erro inclui o campo message com a descrição do problema:

{"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

status.glassdata.io publica a disponibilidade e a agenda de manutenções.

Primeiros passos

Gere uma chave de API no painel.
Valide a chave com o endpoint GET /account.
Cadastre ao menos um tipo de evento com os campos do seu caso de uso.
Envie ocorrências para POST /events informando o type do evento.
Acompanhe os dados no painel em métricas e monitoramentos.

Para entender a modelagem de eventos, consulte Tipo de evento e Evento.