요청
Headers
Name | Type | Description |
Content-Type | string | application/json |
Body Parameters
Name | Type | Required | Description |
title | string | Yes | 모임 제목 |
content | string | Yes | 모임 본문 내용 |
maxMember | int | Yes | 모임 최대 인원 |
gatheringDateTime | Date | Yes | 모임 날짜
(현재 시간에서 + 30분 이후만 가능) |
address | string | No | 모임 장소 명
(address 이름 괜찮나..?) |
latitude | number | No | 위도 |
longitude | number | No | 경도 |
currentMember | number | No | 기본 값으로 1을 보내도 되지만
안 보내도 됨
나아아아중에 여러 명이 모임을 만드는 상황에서 사용할 수 있을 듯? |
Example Request
•
전체 정보 요청
POST /gathering HTTP/1.1
{
"title": "모임 제목 111111111111111111",
"content": "모임 내요요오오오옹 1111111111111111111111111111111111",
"maxMember": 10,
"gatheringDateTime": "2024-11-22T17:30:00.000+09:00", // <-- 00.000
"address": "모임 장소 건물명",
"latitude": 37.4979,
"longitude": 127.0276,
"eupMyeonDong": "읍, 면, 동 (ex, 성수동, .. 등)"
// "currentMember": 1 // 1로 보내도 되고 안 보내도 됨
}
JSON
복사
응답
Response Body
•
현재는 아래처럼 응답이 나가는데 필요 없는 부분이 있다면 얘기해주셈
Name | Type | Description |
id | number | DB, pk id |
Example Response
{
"id": 5,
}
JSON
복사
•
모임 장소 없이 요청
// Reqeust
{
"title": "모임 제목 111111111111111111",
"content": "모임 내요요오오오옹 1111111111111111111111111111111111",
"maxMember": 14,
"gatheringDateTime": "2024-11-22T17:30:00+09:00"
}
JSON
복사
// Response
{
"id": 11,
}
JSON
복사
Error 인 상황들
•
title, content, gatheringDateTime, content 안 채워 졌을 때
HTTP Status Code | Error Code | Message |
400 | INPUT_VALUE_INVALID | erros 형태 봐야 할 듯 |
Example Error Response
{
"code": "INPUT_VALUE_INVALID",
"message": "INPUT_VALUE_INVALID",
"status": 400,
"errors": [
{
"field": "maxMember",
"value": null,
"reason": "널이어서는 안됩니다"
},
{
"field": "title",
"value": null,
"reason": "공백일 수 없습니다"
},
{
"field": "gatheringDateTime",
"value": null,
"reason": "널이어서는 안됩니다"
},
{
"field": "content",
"value": null,
"reason": "공백일 수 없습니다"
}
]
}
JSON
복사
•
모임 인원 15명을 초과 했을 때 Error
•
모임 시간이 현재 시간에서 30분 전일 때 Error
•
위도 33.0 ~ 38.6 사이, 경도 124.6 ~ 131.9 사이를 벗어나면 Error
HTTP Status Code | Error Code | Message |
400 | INPUT_VALUE_INVALID |
{
"code": "INPUT_VALUE_INVALID",
"message": "데이터 형식이 맞지 않습니다.",
"status": 400
}
JSON
복사