Embed Tokens

Crear Embed Token

Changed on

Emite un Embed Token de corta duración que habilita los orígenes indicados.

Se usa como paso previo a montar un componente embebido: se declaran los orígenes desde los que podrá cargarse y se obtiene el token que después se comprueba en POST /embed-tokens/validate.

El token vive 5 minutos desde su emisión. expires_at entrega el instante exacto de expiración en UTC y, pasado ese momento, POST /embed-tokens/validate deja de reconocerlo.

Cada origen se normaliza a scheme://host antes de guardarse: el host pasa a minúsculas y se descartan el puerto, la ruta y el query string. Los orígenes que quedan repetidos tras la normalización se colapsan en uno solo, conservando el orden en que llegaron.

post/embed-tokens

Request

  • Base URL
    https://api.trytoku.com
  • URL
    https://api.trytoku.com/embed-tokens
  • Auth
    API key in header x-api-key

Headers

x-account-keystring

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

Request body

domainsstring[] required

Orígenes que quedan habilitados para el token emitido (entre 1 y 10). Cada entrada debe incluir el esquema: 'https://{host}' para web y Android, o 'capacitor://{host}' para apps iOS hechas con Ionic.

journey_idstring

Identificador opaco del journey de integración al que se asocia el token. Se devuelve tal cual en POST /embed-tokens/validate.

Example request

{
  "domains": [
    "https://app.example.com",
    "capacitor://app.example.com"
  ]
}

Response

Successful Response

domainsstring[] required

Orígenes habilitados por el token, ya normalizados a 'scheme://host' y sin duplicados.

expires_atstring date-time required

Instante en que el token deja de ser válido, en UTC.

journey_idstring

Journey de integración recibido al crear el token, o null cuando no se envió.

tokenstring required

Token emitido. Es el valor que se envía a POST /embed-tokens/validate para comprobar su vigencia.

Example response

{
  "domains": [
    "https://app.example.com",
    "capacitor://app.example.com"
  ],
  "expires_at": "2026-07-26T18:35:00+00:00",
  "token": "Kx7pQmV2aTnR4LcYs9WdF0hJ8bZgE1uNoI6yXvBtA3M"
}

Changes