Creating the Web Socket Connection

Create a websocket

To create a web socket, point a web socket client at:

ws://[server]/api/compute-job-messages

wss://[server]]/api/compute-job-messages

You must supply the bearer token for the authorization header when opening the socket. For information on generating the bearer token using the REST API, see Generate the Bearer Token.

The response will include the header connection-id to indicate the id of the socket. The connection-id is an important value to retain. Each job submission must include this header to associate the job and its progress events with the web socket.

const WebSocket = require('ws');
this.webSocket = new WebSocket(wsAddress, {
    perMessageDeflate: true, //enables message compression
    headers: {
        authorization: 'Bearer ${this._token}'. //token generated from clientId and secret
        Accept: ‘application/vnd.com.fico.xpress.insight.v2+json’
    }
});

ws.on('message', function incoming(data) {
  let message = JSON.parse(data);
  
  if (message.messageType == "JOB_STATUS_UPDATED") {
     //then do something with the status
  } else if (message.messageType == "RUNLOG_UPDATED") {
    //then print the runlog
  } else ….
}
);

Keep Alive Ping

The server will periodically issue ping messages to ensure the client is still alive. The client should respond with a pong message echoing back the contents of the ping. If no pong is received after a five-minute period, the socket is classed as idle and will be disconnected.

Bearer Token Refresh

{
    "messageType": "UPDATE_TOKEN", 
    "messagePayload": {
       "token": "<token_associated_with_the_socket>" 
    }
}

Reconnecting a Socket

ws://[server]/api/compute-job-messages