Notifications and Interactions

The notifications are sent to you via the configured endpoint, see Configure Notification Settings. Nevertheless you might want to render a list of delivered notifications at a later time.

Use following MOOST API to achieve that

Set an Interaction on a delivered Notification

When the push notification is sent to a end-customer (typically to a mobile app), then this person shall have the possibility to interact to the notification. The app shall then send the interaction type with following API call:

Save an interaction on a delivered push notification

post

/pushnotifications/{pushNotificationId}/interactions/v1

Authorizations

Path parameters

pushNotificationIdstringrequired

Select specified notification.

Pattern: ^[a-zA-Z0-9]{24}$

Body

actionQualifierstring

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.moost.io/pushnotifications/{pushNotificationId}/interactions/v1' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "actionQualifier": "text"
  }'

200

200

No body

OK

Example with CURL

# make sure ACCESS_TOKEN is set and valid (see "Request Access Token")
curl -X POST "https://api.moost.io/pushnotifications/668b8e708f308b0123074cb7/interactions/v1" \
     -H  "Authorization: Bearer $ACCESS_TOKEN" \
     -H  "Content-Type: application/json" -d "{\"actionQualifier\":\"OPENWEB\"}"

Load Notifications of a Building

The app shall have the possibility to display the generated notifications. Following API can be used to fulfill this need.

Get push notifications of a building

get

/pushnotifications/buildings/{customerBuildingId}/v1

Authorizations

Path parameters

customerBuildingIdstringrequired

Select notifications of specified building.

Pattern: ^[a-zA-Z0-9:._-]{1,100}$

Query parameters

deliveryStatusstring · enum

If specified, then filter for notifications with specified status.

Options: DELIVERED, DROPPED

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.moost.io/pushnotifications/buildings/{customerBuildingId}/v1' \
  --header 'Authorization: Bearer JWT'

200

200

[
  {
    "id": "text",
    "customerId": "text",
    "customerBuildingId": "text",
    "ruleId": "text",
    "createdAtTimeMillis": 1,
    "interaction": {
      "actionQualifier": "DISMISS"
    },
    "ingestionTimestamp": 1,
    "notification": {
      "command": "text",
      "texts": {
        "ANY_ADDITIONAL_PROPERTY": {
          "title": "text",
          "message": "text",
          "actions": {
            "ANY_ADDITIONAL_PROPERTY": {
              "text": "text",
              "parameter": "text"
            }
          }
        }
      },
      "actionQualifier": {
        "ANY_ADDITIONAL_PROPERTY": "DISMISS"
      }
    },
    "delivery_status": {
      "reason": "text",
      "status": "DELIVERED"
    },
    "priority": "high"
  }
]

OK

Example with CURL

curl -X GET "https://api.moost.io/pushnotifications/buildings/99900000ECA31C6E/v1?deliveryStatus=DELIVERED" \
     -H  "Authorization: Bearer $ACCESS_TOKEN"