Greets

API Documentation

---

Authentication

Login / Register

• POST/login
• Request Params: None
• Request Body:

  {
  "username": "string",
  "password": "string"
  }

• Response:
  • 200 OK (login success) or 201 Created (register success)

  {
  "access_token": "jwt_token"
  }

---

Users

Get All Users

• GET/users
• Request Params: None
• Headers:Authorization: Bearer <token>
• Response:
  • 200 OK

  [
  {
  "id": 1,
  "username": "string"
  }
  ]

---

Rooms

Create Room

• POST/rooms
• Request Params: None
• Headers:Authorization: Bearer <token>
• Request Body:

  {
  "name": "string",
  "description": "string"
  }

• Response:
  • 201 Created

  {
  "id": 1,
  "name": "string",
  "description": "string",
  "OwnerId": 1,
  "roomType": "group-chat",
  ...
  }

Get All Rooms (joined by user)

• GET/rooms
• Request Params: None
• Headers:Authorization: Bearer <token>
• Response:
  • 200 OK

  [
  {
  "UserId": 2,
  "RoomId": 1,
  "createdAt": "2025-07-01T23:31:07.874Z",
  "updatedAt": "2025-07-01T23:31:07.874Z",
  "Room": {
  "id": 1,
  "name": "General Chat",
  "description": "Tempat ngobrol santai semua member.",
  "OwnerId": 2,
  "roomType": "group-chat",
  "createdAt": "2025-07-02T00:00:00.000Z",
  "updatedAt": "2025-07-02T00:00:00.000Z",
  "Owner": {
  "id": 2,
  "username": "Andi"
  }
  }
  }
  ]

---

Chats

Get Chats in Room

• GET/chats/:RoomId
• Request Params:
  • RoomId (path param, integer): Room ID
• Headers:Authorization: Bearer <token>
• Response:
  • 200 OK

  [
  {
  "id": 1,
  "UserId": 2,
  "RoomId": 1,
  "text": "Hello!",
  "createdAt": "2025-07-02T08:00:00.000Z",
  "updatedAt": "2025-07-02T08:00:00.000Z"
  }
  ]

Post Chat in Room

• POST/chats/:RoomId
• Request Params:
  • RoomId (path param, integer): Room ID
• Headers:Authorization: Bearer <token>
• Request Body:

  {
  "text": "string",
  "ChatId": 1// optional, for reply/threads
  }

• Response:
  • 200 OK

  {
  "id": 1,
  "UserId": 2,
  "RoomId": 1,
  "text": "string",
  "createdAt": "2025-07-02T08:00:00.000Z",
  "updatedAt": "2025-07-02T08:00:00.000Z"
  }

Create AI Chat in Room

• POST/rooms/:RoomId/ai-chats
• Request Params:
  • RoomId (path param, integer): Room ID
• Headers:Authorization: Bearer <token>
• Request Body:

  {
  "message": "string"
  }

• Response:
  • 201 Created

  {
  "id": 1,
  "UserId": 1,
  "RoomId": 1,
  "text": "AI response",
  ...
  }

Summarize Room Chat

• POST/rooms/:RoomId/summaries
• Request Params:
  • RoomId (path param, integer): Room ID
• Headers:Authorization: Bearer <token>
• Response:
  • 201 Created

  {
  "id": 1,
  "UserId": 1,
  "RoomId": 1,
  "text": "Summary text",
  ...
  }

---

Private Chat

Create Private Chat Room

• POST/rooms/private
• Request Params: None
• Headers:Authorization: Bearer <token>
• Request Body:

  {
  "targetUserId": 2,
  "message": "string"
  }

• Response:
  • 201 Created

  {
  "message": "Private chat created successfully",
  "room": {
  "id": 1,
  "name": "private-chat-UserA-and-UserB",
  "roomType": "private-chat",
  "OwnerId": 1,
  ...
  }
  }

---

Room Invitation

Invite User to Room

• POST/rooms/:RoomId/invitations
• Request Params:
  • RoomId (path param, integer): Room ID
• Headers:Authorization: Bearer <token>
• Request Body:

  {
  "UserId": 2
  }

• Response:
  • 201 Created

  {
  "message": "User <username> has been invited to room <room name>"
  }

---

Error Handling

• All errors will return a JSON response with a message field describing the error.

---

Notes

• All endpoints (except /login) require JWT authentication via the Authorization header.
• Replace <token> with your JWT access token.
• Replace path params (e.g., :RoomId) with actual values.