API de Live Activities de iOS

Documentación de Apple:

Acerca de las Live Activities

Actualizar y finalizar Live Activities con notificaciones push de ActivityKit

startLiveActivity

Usa este método para crear Live Activities de iOS.

POST https://api.pushwoosh.com/json/1.3/startLiveActivity

Permite crear Live Activities de iOS.

Cuerpo de la solicitud

Parámetro	Tipo	Requerido/Opcional	Descripción
application	String	Requerido	código de aplicación de Pushwoosh
auth	String	Requerido	token de acceso a la API desde el Panel de Control de Pushwoosh.
notifications	Array	Requerido	Array JSON de parámetros de mensaje. Consulta los detalles en la tabla de Notificaciones a continuación.

Notificaciones

Parámetros utilizados en el array notifications:

Parámetro	Tipo	Requerido/Opcional	Descripción
content	String	Requerido	Contenido de respaldo para dispositivos con versiones de iOS inferiores a 16.1 que no admiten Live Activity. En iOS 16.1+ (con soporte para Live Activity), el contenido se obtiene del campo `live_activity`.
title	String	Opcional	El título del mensaje de notificación.
live_activity	Object	Requerido	Datos de Live Activity para crear una Live Activity en iOS.
content-state	Object	Requerido	Contenido para la notificación de Live Activity.
attributes-type	String	Requerido	El tipo de atributos utilizados en la Live Activity.
attributes	Object	Requerido	Atributos para la Live Activity.
live_activity_id	String	Requerido	Un ID único para la Live Activity, creado por el usuario.

Respuesta

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "Messages": [
      "C3F8-C3863ED4-334AD4F1"
    ]
  }
}

Ejemplo de solicitud

{
  "request": {
    "application": "XXXXX-XXXXX",        // requerido. Código de aplicación de Pushwoosh
    "auth": "yxoPUlwqm…………pIyEX4H",      // requerido. Token de acceso a la API desde el Panel de Control de Pushwoosh
    "notifications": [{
      "live_activity": {                 // requerido. Datos de Live Activity para crear una Live Activity en iOS
        "content-state": {
          "emoji": ":wink:"
        },
        "attributes-type": "LiveActivityAttributes",
        "attributes": {
          "name": "Apple"
        }
      },
      "live_activity_id": "unique UUID"  // opcional. Identificador único de la Live Activity.
    }]
  }
}

Nota:

Lee este artículo para aprender más sobre cómo trabajar con Live Activities usando el SDK de iOS de Pushwoosh.

updateLiveActivity

Usa este método para gestionar Live Activities de iOS.

POST https://api.pushwoosh.com/json/1.3/updateLiveActivity

Permite crear y gestionar Live Activities de iOS.

Cuerpo de la solicitud

Parámetro	Tipo	Requerido/Opcional	Descripción
auth	String	Requerido	token de acceso a la API desde el Panel de Control de Pushwoosh.
application	String	Requerido	código de aplicación de Pushwoosh
notifications	Array	Requerido	Array JSON de parámetros de mensaje. Consulta los detalles en la tabla de Notificaciones a continuación.

Notificaciones

Parámetros utilizados en el array notifications:

Parámetro	Tipo	Requerido/Opcional	Descripción
live_activity	Object	Requerido	Datos de Live Activity para actualizar una Live Activity en iOS.
event	String	Requerido	Especifica el tipo de evento. Usa `"update"` para actualizar la Live Activity o `"end"` para cerrarla.
content-state	Object	Requerido	Objeto con pares clave-valor utilizado para pasar datos a la Live Activity para actualizar su contenido.
dismissal-date	Integer	Opcional	El tiempo (en segundos) en el que la Live Activity debe finalizar.
live_activity_id	String	Requerido	Un identificador único para la Live Activity que se está actualizando.
relevance-score	Integer	Opcional	Indica al sistema iOS qué Live Activity tiene mayor prioridad que otras. Acepta valores de 1 al infinito (se recomiendan valores hasta 100).
stale-date	Integer	Opcional	El tiempo (en segundos) que representa la fecha en la que una Live Activity se vuelve obsoleta o caducada.

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "Messages": [
      "C3F8-C3863ED4-334AD4F1"
    ]
  }
}

Ejemplo de solicitud

{
  "request": {
    "application": "XXXXX-XXXXX",        // requerido. Código de aplicación de Pushwoosh
    "auth": "yxoPUlwqm…………pIyEX4H",      // requerido. Token de acceso a la API desde el Panel de Control de Pushwoosh
    "notifications": [{
      "live_activity": {                 // requerido. Datos de Live Activity para actualizar una Live Activity en iOS
        "event": "update",               // requerido. Usa "update" para actualizar la Live Activity o
                                         //           "end" para cerrar la Live Activity
        "content-state": {               // requerido. Objeto con pares clave-valor utilizado para pasar datos
          "courierName": "NUMBER: 15",   //           a la Live Activity para actualizar su contenido
          "deliveryStatus": "Done"
        },
        "dismissal-date": 12345678,      // opcional. Tiempo de finalización de la Live Activity en segundos
        "relevance-score": 50,           // opcional. Prioridad para la Live Activity (se recomienda de 1 a 100)
        "stale-date": 23456789           // opcional. Tiempo (en segundos) en que la Live Activity se vuelve obsoleta
      },
      "live_activity_id": "unique UUID"  // opcional. Identificador único de la Live Activity.
    }]
  }
}

Lee este artículo para aprender más sobre cómo trabajar con Live Activities usando el SDK de iOS de Pushwoosh.