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	array de strings	No	Mecanismo de la V1. Se mantiene para clientes que migran desde esa versión.

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 variables disponibles.
2. Durante el login o el registro, llamar a window.ReskytLayout.device.getHashedInstallationId().
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.

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"]
  }'