Viz Pilot User Guide

Version 8.1 | Published August 16, 2017 ©

Change Notifications

Change notifications are available through the REST API and the STOMP protocol on the Pilot Data Server.

REST API

List of database changes ordered from most recent to least recent.

  • Located at http://pdshost:8177/changelog

  • Parameters:

    • startId: The ID of the least recent change, or -1 for no limit. Default is -1.

    • lastKnownId: The ID of the most recent change, or -1 for no limit. Default is -1.

STOMP API

In a Viz Pilot system, the text based message protocol STOMP (Streaming Text Oriented Messaging Protocol) is used to subscribe to change notifications from Graphic Hub REST and Pilot Data Server. It provides push notifications of new changes.

  • Located at:
    stomp://pdshost:9876/?destination=/changelog&lastKnownId=-1

  • Parameters:

    • lastKnownId: Mandatory, should be the ID in the STOMP link that is provided by the REST API.
      For example, when the data stored in the Pilot database changes, a message is delivered to all of the STOMP clients that are subscribed to the server.