# API für iOS Live-Aktivitäten > Apple-Dokumentation: > > * [Über Live-Aktivitäten](https://developer.apple.com/design/human-interface-guidelines/live-activities) > * [Aktualisieren und Beenden von Live-Aktivitäten mit ActivityKit-Push-Benachrichtigungen](https://developer.apple.com/documentation/activitykit/updating-and-ending-your-live-activity-with-activitykit-push-notifications) ## startLiveActivity `POST` `https://api.pushwoosh.com/json/1.3/startLiveActivity` Ermöglicht das Erstellen von iOS Live-Aktivitäten. ### Anfragekörper | Parameter | Typ | Erforderlich/Optional | Beschreibung | |---------------|--------|-------------------|-----------------------------------------------------------------------------| | application | String | Erforderlich | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) | | auth | String | Erforderlich | [API-Zugriffstoken](/de/developer/api-reference/api-identifiers/#api-access-token) aus dem Pushwoosh Control Panel. | | notifications | Array | Erforderlich | JSON-Array mit 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-Aktivitäten nicht unterstützen. Auf iOS 16.1+ (mit Unterstützung für Live-Aktivitäten) stammt der Inhalt aus dem Feld `live_activity`. | | title | String | Optional | Der Titel der Benachrichtigungsnachricht. | | live_activity | Object | Erforderlich | Live-Aktivitätsdaten zum Erstellen einer Live-Aktivität in iOS. | | live_activity.content-state | Object | Erforderlich | Inhalt für die Live-Aktivitätsbenachrichtigung. | | live_activity.attributes-type | String | Erforderlich | Der Typ der in der Live-Aktivität verwendeten Attribute. | | live_activity.attributes | Object | Erforderlich | Attribute für die Live-Aktivität. | | live_activity_id | String | Erforderlich | Ein eindeutiger Bezeichner für die Live-Aktivität. Wird verwendet, um diese Aktivität beim Aufruf von `updateLiveActivity` gezielt anzusprechen. Muss pro Aktivitätssitzung eindeutig sein. | | filter | String | Optional | Der Name eines Pushwoosh-Filters (Segments). Siehe [Segment- / Filtername](/de/developer/api-reference/api-identifiers/#segment--filter-name). Die Live-Aktivität wird auf allen Geräten gestartet, die diesem Filter entsprechen. | | devices | Array of Strings | Optional | Eine Liste von [Geräte-Tokens](/de/developer/api-reference/api-identifiers/#push-token). Die Live-Aktivität wird nur auf den angegebenen Geräten gestartet. | ### Anfragebeispiel ```json { "request": { "application": "XXXXX-XXXXX", "auth": "SECRET_API_TOKEN", "notifications": [ { "content": "Your order is being prepared", "title": "Food Delivery", "live_activity": { "event": "start", "title": "Order status", "content-state": { "status": "Third", "estimatedTime": "37 min", "emoji": "👨‍🍳" }, "attributes-type": "FoodDeliveryAttributes", "attributes": {} }, "live_activity_id": "FIRST_LIVE_ACTIVITY", "filter": "FILTER_NAME_1" } ] } } ``` ```json { "request": { "application": "XXXXX-XXXXX", "auth": "SECRET_API_TOKEN", "notifications": [ { "content": "Your order is being prepared", "title": "Food Delivery", "live_activity": { "event": "start", "title": "Order status", "content-state": { "status": "Third", "estimatedTime": "37 min", "emoji": "👨‍🍳" }, "attributes-type": "FoodDeliveryAttributes", "attributes": {} }, "live_activity_id": "SECOND_LIVE_ACTIVITY", "devices": ["first_third", "second_device"] } ] } } ``` ### Antwortbeispiel ```json { "status_code": 200, "status_message": "OK", "response": { "Messages": [ "XXXXX-XXXXXXXX-XXXXXXXX" ] } } ``` > **Hinweis:** > > Lesen Sie [diesen Artikel](/de/developer/pushwoosh-sdk/ios-sdk/ios-live-activities), um mehr über die Arbeit mit Live-Aktivitäten mit dem Pushwoosh iOS SDK zu erfahren. ## updateLiveActivity `POST` `https://api.pushwoosh.com/json/1.3/updateLiveActivity` Ermöglicht das Aktualisieren und Beenden von iOS Live-Aktivitäten ### Anfragekörper | Parameter | Typ | Erforderlich/Optional | Beschreibung | |----------------|--------|-------------------|------------------------------------------------------------------------| | auth | String | Erforderlich | [API-Zugriffstoken](/de/developer/api-reference/api-identifiers/#api-access-token) aus dem Pushwoosh Control Panel. | | application | String | Erforderlich | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) | | notifications | Array | Erforderlich | JSON-Array mit 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-Aktivitätsdaten zum Aktualisieren einer Live-Aktivität in iOS. | | live_activity.event | String | Erforderlich | Gibt den Ereignistyp an. Verwenden Sie `"update"`, um die Live-Aktivität zu aktualisieren, oder `"end"`, um sie zu schließen. | | live_activity.content-state | Object | Erforderlich | Objekt mit Schlüssel-Wert-Paaren, das verwendet wird, um Daten an die Live-Aktivität zu übergeben, um deren Inhalt zu aktualisieren. | | live_activity.dismissal-date | Integer | Optional | Die Zeit (in Sekunden), zu der die Live-Aktivität enden soll. | | live_activity_id | String | Erforderlich | Der eindeutige Bezeichner der zu aktualisierenden Live-Aktivität. Muss mit der in **startLiveActivity** verwendeten `live_activity_id` übereinstimmen. Das Update wird an alle Geräte ausgeliefert, auf denen diese Aktivität gestartet wurde. | | live_activity.relevance-score | Integer | Optional | Teilt dem iOS-System mit, welche Live-Aktivität eine höhere Priorität als andere hat. Akzeptiert Werte von 1 bis unendlich (Werte bis 100 werden empfohlen). | | live_activity.stale-date | Integer | Optional | Die Zeit (in Sekunden), die das Datum darstellt, an dem eine Live-Aktivität veraltet oder nicht mehr aktuell ist.| ### Anfragebeispiel ```json { "request": { "application": "XXXXX-XXXXX", "auth": "SECRET_API_TOKEN", "notifications": [ { "live_activity": { "event": "update", "title": "Live Activity Update", "content-state": { "status": "second 66", "estimatedTime": "66 min", "emoji": "👨‍" }, "relevance-score": 60 }, "live_activity_id": "FIRST_LIVE_ACTIVITY" } ] } } ``` ### Antwortbeispiel ```json { "status_code": 200, "status_message": "OK", "response": { "Messages": [ "XXXXX-XXXXXXXX-XXXXXXXX" ] } } ``` > [Lesen Sie diesen Artikel](/de/developer/pushwoosh-sdk/ios-sdk/ios-live-activities/), um mehr über die Arbeit mit Live-Aktivitäten mit dem Pushwoosh iOS SDK zu erfahren. ## Mehrere Aktivitäten pro Gerät Sie können mehrere Live-Aktivitäten auf demselben Gerät starten, indem Sie `startLiveActivity` mehrmals mit unterschiedlichen `live_activity_id`-Werten aufrufen. Wenn Sie beispielsweise zwei Aktivitäten starten: `FIRST_LIVE_ACTIVITY` mit `filter: FILTER_NAME_1` und `SECOND_LIVE_ACTIVITY` mit `filter: FILTER_NAME_2`, wird ein Gerät, das beiden Filtern entspricht, beide Aktivitäten gleichzeitig ausführen. Um eine davon zu aktualisieren, übergeben Sie ihre `live_activity_id` an `updateLiveActivity`. Das Update wird an alle Geräte ausgeliefert, auf denen diese Aktivität erstellt wurde. Die andere Aktivität ist nicht betroffen. Der Parameter `relevance-score` steuert die Anzeigepriorität, wenn mehrere Live-Aktivitäten auf demselben Gerät aktiv sind. Wenn der Bildschirmplatz begrenzt ist oder Aktivitäten gruppiert sind, wird die Aktivität mit einem höheren Wert mit höherer Priorität angezeigt.