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
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | number | No | Page number, default 1 |
| limit | number | No | Items 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
| Parameter | Type | Required | Description |
|---|---|---|---|
| nickname | string | Yes | Nickname (required for non-logged-in users) |
| content | string | Yes | Message content |
| string | No | ||
| website | string | No | Website 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 Code | Description |
|---|---|
| 400 | Parameter error |
| 500 | Server error |
Limitations
- Message content maximum 500 characters
- Nickname maximum 50 characters
- Email format validation required
- Website link format validation required