Skip to content

Online Chat

The /chat endpoint allows retrieving and sending messages in a global or private chat.

Get Messages

The /chat endpoint retrieves all messages sent during the last hour. This endpoint does not require any options.

Request Example

GET /v2/chat

Response

json
[
    {
      "username": "User1",
      "message": "Hi!",
      "timestamp": "2025-01-21T08:27:11.068Z"
    },
    {
      "username": "User3",
      "message": "How are you?",
      "timestamp": "2025-01-21T08:28:43.070Z"
    },
    {
      "username": "User8",
      "message": "Yeah great, and you?",
      "timestamp": "2025-01-21T08:32:07.215Z"
    }
]

cURL

bash
curl -X GET "https://api.sylvain.pro/v2/chat"

Send Message

The /chat endpoint allows sending a message to the global chat or a private chat.

Parameters

ParameterRequiredDescription
usernameYesThe username of the user who sends the message
messageYesThe message to send
sessionYesThe session ID of the user
tokenNoThe key used to connect to a private chat. If not provided, the message will be sent to the global chat

Request Example

bash
curl -X POST -d "username=User3&message=How are you?&session=abc123&token=41a43360-9874-4c7a-9ca8-eec29e765a0e" "https://api.sylvain.pro/v2/chat"

Response

json
{
  "message": "Message sent successfully"
}

Error Handling

If the value of username, message or session is empty, an error will be returned.