Cloud API Push notifications

For receiving push notifications for ring or motion events, a dedicated endpoint is required to which the API can send the notifications.

This endpoint is only necessary if the service would like to get direct push notifications and does not use the favorite and schedule options for HTTP(S) notifications from the DoorBird.

You can request the integration of the endpoint for your company by contacting DoorBird and sending the endpoint URL.

You will receive a key, which will be used by the Cloud API to authenticate at your endpoint. The endpoint should validate the key to prevent unauthorized access.

The following line shows the authentication header which will be send by the Cloud API:

Authorization: key=RECEIVED_ENDPOINT_KEY

The actual notification data are send as an application/json POST request including the notification data in the body:

{
    "timestamp": <timestamp in seconds>,
    "intercomid": "<f.e. abcdef>",
    "mac": "<f.e. 1CCAE3700000>",
    "user": "<f.e. abcdef0001>",
    "event": "<doorbell or motion>",
    "eventparam": "<doorbell number or motion for motion events>"
    "peripheral": "<optional peripheral id if the push is coming from a peripheral device>"
}