Web Sockets

Request of the current type are aimed to sending messages to users.They perform similar actions - sending any messages, but are used in different cases. They also have a specific feature. After using these requests, in addition to the response, there will also be web socket messages.

There are two such requests:

1. ws/emit-to-user
2. ws/broadcast-to-app-subscribers

ws/emit-to-user

The first request allows you to send various messages to a specific person, or rather, a user.

Request

It consist of the data object that contains the message, an access token and the user ID.

Example:

data: {some_data: ‘here’,…}
token: "xDDdP3FhfYamgo8XEqdrtgfhyjq4hg2A443zTL6fyRNvGSvuQoxXGCS"
user_id: 22

Response

In response, we receive all the data that was passed in the request, the API, and the sender's default application ID, which is created when the user has just registered.

api: "/ws/emit-to-user"
app_id: 178
response: {some_data: ‘here’,…}
token: "xDDdP3FhfYamgo8XEqdrtgfhyjq4hg2A443zTL6fyRNvGSvuQoxXGCS"
user_id: 22

WebSocket Message

The recipient user will receive the following WebSocket message. It is very similar to the request response, but the user_id is an ID of the message sender.

api: "/ws/emit-to-user"
app_id: 178
response: {some_data: ‘here’,…}
token: "xDDdP3FhfYamgo8XEqdrtgfhyjq4hg2A443zTL6fyRNvGSvuQoxXGCS"
user_id: 1

Status Code

ws/broadcast-to-app-subscribers

This request is different from the first one, which sends a message to all users subscribed to one specific app.

Request

The request contains a data object with a message inside, an access token, and an application with recipient users.

Example:

app_id: 178
data: {some_data: ‘here’,…}
token: "xDDdP3FhfYamgo8XEqdrtgfhyjq4hg2A443zTL6fyRNvGSvuQoxXGCS"

Response

It returns all the data that was sent, the AP, and the sender ID in the initialized app that was created when that user first signed up.

api: "/ws/broadcast-to-app-user"
app_id: 178
response: {some_data: ‘here’,…}
token: "xxDDdP3FhfYamgo8XEqdrtgfhyjq4hg2A443zTL6fyRNvGSvuQoxXGCS"

WebSocket Message

In case of this request, all users which subscribed on the specific application will receive the web socket message. It contains all the same data as the response to the request, as well as the sender's ID.

api: "/ws/broadcast-to-app-user"
app_id: 178
response: {some_data: ‘here’,…}
token: "xDDdP3FhfYamgo8XEqdrtgfhyjq4hg2A443zTL6fyRNvGSvuQoxXGCS"
user_id: 1

Status Code