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

Utilize Basic Auth com o ID da chave como usuário e a chave secreta como senha. As credenciais são geradas no painel da plataforma.

Para validar sua chave:

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 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:

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

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.