Chat Events 0.1.0 documentation

info

In this document, PUB means "publish" and SUB means "subscribe". This refers to the "publish/subscribe" (pub/sub) messaging framework, where "publish" means that the service sends data to Kafka topics, and "subscribe" means the service acts as a consumer that subscribes to specific Kafka topics to receive data.

• Specification ID: http://chat-service
• Protobuf File Spec: chat.proto

Table of Contents

• Operations
  • PUB personalChat
  • PUB chat

Operations

PUB personalChat Operation

Message personalChatSent

Payload

Name	Type	Description	Value	Constraints	Notes
(root)	allOf	-	-	-	additional properties are allowed
payload	-	-	-	-	additional properties are allowed
payload.personalChatSent	object	-	-	-	additional properties are allowed
payload.personalChatSent.message_id	string	-	-	format (uuid)	-
payload.personalChatSent.sender_id	string	-	-	format (uuid)	-
payload.personalChatSent.target_id	string	Can be partyId or userId	-	format (uuid)	-
payload.personalChatSent.payload	string	-	-	-	-
payload.personalChatSent.target_type	string	-	-	-	-
payload.personalChatSent.target_members	array<string>	-	-	-	-
payload.personalChatSent.target_members (single item)	string	-	-	-	-
0 (allOf item)	object	-	-	-	additional properties are allowed
id	string	-	-	-	-
version	integer	-	-	-	-
name	string	-	-	-	-
namespace	string	-	-	-	-
parentNamespace	string	-	-	-	-
timestamp	string	-	-	format (date-time)	-
clientId	string	-	-	-	-
userId	string	UserId of the operator for this event (optional)	-	-	-
traceId	string	-	-	-	-
sessionId	string	-	-	-	-
spanContext	string	-	-	-	-

Examples of payload (generated)

{
  "payload": {
    "personalChatSent": {
      "message_id": "d7d9d9fd-478f-40e6-b651-49b7f19878a2",
      "sender_id": "3194e023-c19f-4a42-9172-9e18d68e3a3a",
      "target_id": "d3bcdc92-4191-401b-ad0c-42056c6efab9",
      "payload": "string",
      "target_type": "string",
      "target_members": [
        "string"
      ]
    }
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "clientId": "string",
  "userId": "string",
  "traceId": "string",
  "sessionId": "string",
  "spanContext": "string"
}

PUB chat Operation

Accepts one of the following messages:

Message userConnected

Payload

Name	Type	Description	Value	Constraints	Notes
(root)	allOf	-	-	-	additional properties are allowed
payload	-	-	-	-	additional properties are allowed
payload.userConnected	object	-	-	-	additional properties are allowed
0 (allOf item)	object	-	-	-	additional properties are allowed
id	string	-	-	-	-
version	integer	-	-	-	-
name	string	-	-	-	-
namespace	string	-	-	-	-
parentNamespace	string	-	-	-	-
timestamp	string	-	-	format (date-time)	-
clientId	string	-	-	-	-
userId	string	UserId of the operator for this event (optional)	-	-	-
traceId	string	-	-	-	-
sessionId	string	-	-	-	-
spanContext	string	-	-	-	-

Examples of payload (generated)

{
  "payload": {
    "userConnected": {}
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "clientId": "string",
  "userId": "string",
  "traceId": "string",
  "sessionId": "string",
  "spanContext": "string"
}

Message userDisconnected

Payload

Name	Type	Description	Value	Constraints	Notes
(root)	allOf	-	-	-	additional properties are allowed
payload	-	-	-	-	additional properties are allowed
payload.userDisconnected	object	-	-	-	additional properties are allowed
payload.userDisconnected.reason	string	-	-	-	-
payload.userDisconnected.code	integer	-	-	-	-
payload.userDisconnected.forced	boolean	-	-	-	-
0 (allOf item)	object	-	-	-	additional properties are allowed
id	string	-	-	-	-
version	integer	-	-	-	-
name	string	-	-	-	-
namespace	string	-	-	-	-
parentNamespace	string	-	-	-	-
timestamp	string	-	-	format (date-time)	-
clientId	string	-	-	-	-
userId	string	UserId of the operator for this event (optional)	-	-	-
traceId	string	-	-	-	-
sessionId	string	-	-	-	-
spanContext	string	-	-	-	-

Examples of payload (generated)

{
  "payload": {
    "userDisconnected": {
      "reason": "string",
      "code": 0,
      "forced": true
    }
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "clientId": "string",
  "userId": "string",
  "traceId": "string",
  "sessionId": "string",
  "spanContext": "string"
}

Message userChatRateLimited

Payload

Name	Type	Description	Value	Constraints	Notes
(root)	allOf	-	-	-	additional properties are allowed
payload	-	-	-	-	additional properties are allowed
payload.userChatRateLimited	object	-	-	-	additional properties are allowed
0 (allOf item)	object	-	-	-	additional properties are allowed
id	string	-	-	-	-
version	integer	-	-	-	-
name	string	-	-	-	-
namespace	string	-	-	-	-
parentNamespace	string	-	-	-	-
timestamp	string	-	-	format (date-time)	-
clientId	string	-	-	-	-
userId	string	UserId of the operator for this event (optional)	-	-	-
traceId	string	-	-	-	-
sessionId	string	-	-	-	-
spanContext	string	-	-	-	-

Examples of payload (generated)

{
  "payload": {
    "userChatRateLimited": {}
  },
  "id": "string",
  "version": 0,
  "name": "string",
  "namespace": "string",
  "parentNamespace": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "clientId": "string",
  "userId": "string",
  "traceId": "string",
  "sessionId": "string",
  "spanContext": "string"
}