iOS Live Activities API

Apple-Dokumentation:

Über Live Activities

Aktualisieren und Beenden von Live Activities mit ActivityKit-Push-Benachrichtigungen

startLiveActivity

Verwenden Sie diese Methode, um iOS Live Activities zu erstellen.

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

Ermöglicht das Erstellen von iOS Live Activities.

Anfragekörper

Parameter	Typ	Erforderlich/Optional	Beschreibung
application	String	Erforderlich	Pushwoosh-Anwendungscode
auth	String	Erforderlich	API-Zugriffstoken aus dem Pushwoosh Control Panel.
notifications	Array	Erforderlich	JSON-Array von Nachrichtenparametern. Details finden Sie in der nachstehenden Tabelle „Benachrichtigungen“.

Benachrichtigungen

Parameter, die im notifications-Array verwendet werden:

Parameter	Typ	Erforderlich/Optional	Beschreibung
content	String	Erforderlich	Fallback-Inhalt für Geräte mit iOS-Versionen unter 16.1, die Live Activity nicht unterstützen. Auf iOS 16.1+ (mit Live Activity-Unterstützung) wird der Inhalt aus dem Feld `live_activity` bezogen.
title	String	Optional	Der Titel der Benachrichtigungsnachricht.
live_activity	Object	Erforderlich	Live Activity-Daten zum Erstellen einer Live Activity in iOS.
content-state	Object	Erforderlich	Inhalt für die Live Activity-Benachrichtigung.
attributes-type	String	Erforderlich	Der Typ der in der Live Activity verwendeten Attribute.
attributes	Object	Erforderlich	Attribute für die Live Activity.
live_activity_id	String	Erforderlich	Eine eindeutige ID für die Live Activity, die vom Benutzer erstellt wird.

Antwort

200

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

Anfragebeispiel

{
  "request": {
    "application": "XXXXX-XXXXX",        // required. Pushwoosh application code
    "auth": "yxoPUlwqm…………pIyEX4H",      // required. API access token from Pushwoosh Control Panel
    "notifications": [{
      "live_activity": {                 // required. Live Activity data to create Live Activity in iOS
        "content-state": {
          "emoji": ":wink:"
        },
        "attributes-type": "LiveActivityAttributes",
        "attributes": {
          "name": "Apple"
        }
      },
      "live_activity_id": "unique UUID"  // optional. Unique identifier of the Live Activity.
    }]
  }
}

Hinweis:

Lesen Sie diesen Artikel, um mehr über die Arbeit mit Live Activities mit dem Pushwoosh iOS SDK zu erfahren.

updateLiveActivity

Verwenden Sie diese Methode, um iOS Live Activities zu verwalten.

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

Ermöglicht das Erstellen und Verwalten von iOS Live Activities.

Anfragekörper

Parameter	Typ	Erforderlich/Optional	Beschreibung
auth	String	Erforderlich	API-Zugriffstoken aus dem Pushwoosh Control Panel.
application	String	Erforderlich	Pushwoosh-Anwendungscode
notifications	Array	Erforderlich	JSON-Array von Nachrichtenparametern. Details finden Sie in der nachstehenden Tabelle „Benachrichtigungen“.

Benachrichtigungen

Parameter, die im notifications-Array verwendet werden:

Parameter	Typ	Erforderlich/Optional	Beschreibung
live_activity	Object	Erforderlich	Live Activity-Daten zum Aktualisieren einer Live Activity in iOS.
event	String	Erforderlich	Gibt den Ereignistyp an. Verwenden Sie `"update"`, um die Live Activity zu aktualisieren, oder `"end"`, um sie zu schließen.
content-state	Object	Erforderlich	Objekt mit Schlüssel-Wert-Paaren, das verwendet wird, um Daten an die Live Activity zu übergeben, um deren Inhalt zu aktualisieren.
dismissal-date	Integer	Optional	Die Zeit (in Sekunden), zu der die Live Activity enden soll.
live_activity_id	String	Erforderlich	Ein eindeutiger Bezeichner für die Live Activity, die aktualisiert wird.
relevance-score	Integer	Optional	Teilt dem iOS-System mit, welche Live Activity eine höhere Priorität als andere hat. Akzeptiert Werte von 1 bis unendlich (Werte bis 100 werden empfohlen).
stale-date	Integer	Optional	Die Zeit (in Sekunden), die das Datum darstellt, an dem eine Live Activity veraltet oder nicht mehr aktuell ist.

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

Anfragebeispiel

{
  "request": {
    "application": "XXXXX-XXXXX",        // required. Pushwoosh application code
    "auth": "yxoPUlwqm…………pIyEX4H",      // required. API access token from Pushwoosh Control Panel
    "notifications": [{
      "live_activity": {                 // required. Live Activity data to update Live Activity in iOS
        "event": "update",               // required. Use "update" to update Live Activity or
                                         //           "end" to close Live Activity
        "content-state": {               // required. Object with key-value pairs used to pass data
          "courierName": "NUMBER: 15",   //           to Live Activity for updating its content
          "deliveryStatus": "Done"
        },
        "dismissal-date": 12345678,      // optional. Time of ending Live Activity in seconds
        "relevance-score": 50,           // optional. Priority for the Live Activity (1 to 100 recommended)
        "stale-date": 23456789           // optional. Time (in seconds) when Live Activity becomes stale
      },
      "live_activity_id": "unique UUID"  // optional. Unique identifier of the Live Activity.
    }]
  }
}

Lesen Sie diesen Artikel, um mehr über die Arbeit mit Live Activities mit dem Pushwoosh iOS SDK zu erfahren.