Skip to content

Wall Messages

Interface for managing messages.

Get Message List

Get all public messages.

Interface Information

  • Endpoint: GET /api/wall-messages
  • Authentication: Not required (public interface)

Query Parameters

ParameterTypeRequiredDescription
pagenumberNoPage number, default 1
limitnumberNoItems per page, default 20

Create Message

Submit a new message.

Interface Information

  • Endpoint: POST /api/wall-messages
  • Authentication: Optional (logged-in users will have user information recorded)

Request Parameters

ParameterTypeRequiredDescription
nicknamestringYesNickname (required for non-logged-in users)
contentstringYesMessage content
emailstringNoEmail
websitestringNoWebsite link

Request Example

bash
curl -X POST http://localhost:3000/api/wall-messages \
  -H "Content-Type: application/json" \
  -d '{
    "nickname": "Guest",
    "content": "Message content",
    "email": "guest@example.com"
  }'

Response Example (Message List)

json
{
  "success": true,
  "data": [
    {
      "id": 1,
      "nickname": "Guest",
      "content": "Message content",
      "avatar": "https://example.com/avatar.jpg",
      "createdAt": "2024-01-15T10:00:00.000Z"
    }
  ],
  "total": 50,
  "page": 1,
  "limit": 20
}

Error Responses

HTTP Status CodeDescription
400Parameter error
500Server error

Limitations

  • Message content maximum 500 characters
  • Nickname maximum 50 characters
  • Email format validation required
  • Website link format validation required