# 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

La API usa HTTP Basic con credenciales generadas en [Claves API](/es/api/api-keys/). Para validar una clave existente:

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

Respuesta esperada:

```json
{"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:

```json
{"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](https://status.glassdata.io).

## Primeros pasos

1. Genere una [clave de API](/es/api/api-keys/) en el panel.
2. Valide la clave con el endpoint `GET /account`.
3. Registre al menos un tipo de evento con los campos de su caso de uso.
4. Envíe ocurrencias a `POST /events` indicando el `type` del evento.
5. Siga los datos en el panel en métricas y monitoreos.

Para entender el modelado de eventos, consulte [Tipo de evento](/es/events/event_types/) y [Evento](/es/events/events/).