Integración técnica

La API de Glass Data es una API REST alojada en https://api.glassdata.io. Integre la API solo por el backend: no exponga las credenciales en clientes públicos.

Autenticación

La API usa HTTP Basic con credenciales generadas en Claves API. Para validar una clave ya creada:

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

Respuesta esperada:

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

Formato

Las solicitudes con cuerpo (POST, PATCH) deben usar Content-Type: application/json. Las respuestas también viajan en JSON.

Errores

La API devuelve códigos HTTP estándar. Un error incluye el campo message con la descripción del problema:

{"message":"invalid credentials"}

Código	Significado
`400`	Solicitud inválida; verifique el payload
`401`	Credenciales ausentes o incorrectas
`403`	Sin permiso para este recurso
`404`	Recurso no encontrado
`422`	Datos válidos pero rechazados por la lógica de la plataforma
`500`	Error interno; contacte con soporte si persiste

Estado de la plataforma

status.glassdata.io publica la disponibilidad y la agenda de mantenimientos.

Primeros pasos

Genere una clave de API en el panel.
Valide la clave con el endpoint GET /account.
Registre al menos un tipo de evento con los campos de su caso de uso.
Envíe ocurrencias a POST /events indicando el type del evento.
Siga los datos en el panel en métricas y monitoreos.

Para entender el modelado de eventos, consulte Tipo de evento y Evento.