Integración técnica

La API de Glass Data es una API REST alojada en https://api.glassdata.io. La integración debe realizarse exclusivamente vía backend — las credenciales no deben exponerse en clientes públicos.

Autenticación

Use Basic Auth con el ID de la clave como usuario y la clave secreta como contraseña. Las credenciales se generan en el panel de la plataforma.

Para validar su clave:

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 se devuelven en JSON.

Errores

La API devuelve códigos HTTP estándar. Los errores incluyen un 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 al soporte si persiste

Estado de la plataforma

Disponibilidad y agenda de mantenimientos en status.glassdata.io.

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.