Online Chat

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

Get Messages

GET/v2/chat

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

Request Example

GET /v2/chat

Response

[
    {
        "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

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

---

Send Message

POST/v2/chat

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

Parameters

Parameter	Required	Description
username	Yes	The username of the user who sends the message
message	Yes	The message to send
session	Yes	The session ID of the user
token	No	The key used to connect to a private chat. If not provided, the message will be sent to the global chat

Request Example

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

Response

{
    "message": "Message sent successfully"
}

Error Handling

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