La API REST te deja integrar cualquier sistema con Segmentados. La convención es REST con recursos en plural y kebab-case, y el acceso está gobernado por tokens con scopes.
Autenticación
Usá client_credentials: pedís un token con tus credenciales y lo mandás como
Authorization: Bearer. El token dura 1 hora.curl -X POST \
https://api.segmentados.com/t/{account}/{dataset}/{environment}/auth/token \
-H 'Content-Type: application/json' \
-d '{ "client_id": "...", "client_secret": "..." }'Scopes
Cada token trae los scopes que le habilitás (por ejemplo
Segments.readAll o Integrations.create). Un pedido a un recurso sin el scope correspondiente se rechaza. Así das acceso mínimo y auditable a cada integración.Clientes y errores
Antes de pedir un token creás un client (client_id + client_secret) y le asignás sus scopes. Podés revocarlo cuando quieras, y cada cliente lleva un historial de eventos (incluido cuando se le niega un pedido por falta de scope o token inválido), para auditar quién intentó qué.
| Respuesta | Qué significa | Qué hacer |
|---|---|---|
| 401 No autorizado | Token ausente, mal formado o vencido (dura 1 hora). | Pedí un token nuevo con client_credentials y reintentá. |
| 403 Prohibido | El token es válido pero no tiene el scope del recurso. | Agregá el scope al cliente (o usá un cliente que lo tenga). |
| El cliente fue revocado | El client_id ya no puede emitir tokens. | Usá otro cliente; la revocación queda registrada en el historial. |
Nota
Para ingesta de eventos desde el navegador se usa una write key pública (no un token de servidor). Ver SDK web.