API de notificaciones push

La API de push permite enviar notificaciones desde tus propios sistemas (CRM, ERP, automatizaciones de marketing) sin pasar por el backoffice. Es actualmente la única API pública documentada de Reskyt.

Autenticación

Cabecera	Valor	Obligatoria
Content-Type	application/json	Sí
x-api-key	Tu API key	Sí

Las API keys se generan desde el panel de Reskyt.

Precaución

La API key da permiso para notificar a todos tus dispositivos. Úsala siempre desde servidor, nunca desde el código de la web o de la app.

Endpoint

POST https://push.api.reskyt.com/push/send

Payload

{
  "title": "Tu pedido va en camino",
  "heading": "Envío",
  "dateEnd": 1790000000,
  "url": "https://tutienda.com/ofertas",
  "pictureUrl": "https://tutienda.com/img/preview.jpg",
  "utmCampaign": "black_friday_2026",
  "deviceId": [
    "41dc840f7e76bcec71a40bce87699431",
    "076b3c207b9a010d654efdfab92cb898"
  ]
}

Campos

Campo	Tipo	Obligatorio	Descripción
title	string	Sí	Texto o cuerpo de la notificación.
heading	string	No	Título de la notificación.
deviceId	string[]	Sí en V2	Destinatarios del envío, identificados por su hashed installation ID.
dateEnd	number	No	Timestamp Unix en segundos en el que caduca la notificación. Si no se especifica, la API aplica 7 días desde el envío.
url	string	No	URL que se abre al pulsar la notificación.
pictureUrl	string	No	URL de la imagen de previsualización.
utmCampaign	string	No	Identificador o etiqueta de campaña.
tokens	string[]	Solo en V1	Destinatarios identificados por su token push en MD5. Solo para clientes que vienen de la V1; en la V2 se usa deviceId.

deviceId transporta hashed installation IDs, no tokens de APNs ni de FCM. El flujo recomendado para obtenerlos es:

1. Comprobar que el user agent contiene rktwebview, que es lo que indica que el código se está ejecutando dentro de la app. Ver detectar que estás dentro de la app.
2. Durante el login o el registro, llamar a window.ReskytLayout.device.getId(), que devuelve una promesa.
3. Guardar el hashed installation ID devuelto.
4. Asociarlo al usuario correspondiente en tus sistemas.
5. Utilizarlo después como valor de deviceId en los envíos.

Sin el paso 4 no es posible segmentar por cliente.

Migrar desde la V1

Si ya envías notificaciones con la V1, puedes seguir haciéndolo con los tokens que tienes guardados en tokens.

Para pasar a la V2, empieza a guardar el hashed installation ID de cada dispositivo, siguiendo el flujo anterior, del mismo modo que guardabas los tokens, y envíalo en deviceId. Los tokens push pueden cambiar con el tiempo, mientras que el hashed installation ID se mantiene mientras la app siga instalada.

Ejemplo

curl -X POST https://push.api.reskyt.com/push/send \
  -H "Content-Type: application/json" \
  -H "x-api-key: $RESKYT_API_KEY" \
  -d '{
    "title": "Tu pedido va en camino",
    "heading": "Envío",
    "dateEnd": 1790000000,
    "url": "https://tutienda.com/pedidos/1234",
    "deviceId": ["41dc840f7e76bcec71a40bce87699431"]
  }'