마이페이지

• 내 정보를 반환받는 기능입니다.
• HTTP 헤더의 Authorization 필드에 Access Token을 포함하여 전송해야 합니다.

GET /users/me

성공: 200 OK
실패:

Code	Message	Description
401	Access Token 만료	사용자의 Access Token이 만료되었거나 유효하지 않은 경우

요청 헤더

Name	Description
Authorization	Bearer + JWT Access Token

요청 파라미터
없음

요청 필드
없음

응답 필드

Field	Type	Description
nickname	String	닉네임
introduction	String	자기소개
score	Integer	별점
gold	Integer	금메달 개수
silver	Integer	은메달 개수
bronze	Integer	동메달 개수
userid	Integer	회원ID (DB 기본키)

요청 예시(URI, 헤더)

GET /users/me

Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiI0IiwiYXV0aCI6IlJPT...

응답 예시(JSON)

{
  "nickname": "닉네임A",
  "introduction": "안녕하세요. 닉네임A 입니다. 반갑습니다.",
  "score": 85,
  "gold": 0,
  "silver": 0,
  "bronze": 3,
  "userid": 8
}

게시판 조회

• 게시판의 게시글 리스트를 조회하는 기능입니다.
• HTTP 헤더의 Authorization 필드에 Access Token을 포함하여 전송해야 합니다.

GET /notices

성공: 200 OK
실패:

Code	Message	Description
401	Access Token 만료	사용자의 Access Token이 만료되었거나 유효하지 않은 경우
400	유효하지 않은 게시판명	게시판명이 "원정대" or "의뢰인"이 아닌 경우
400	유효하지 않은 lastid	lastid 값이 존재하지 않는 경우
400	필수 파라미터 전달 누락	필수로 입력해야하는 파라미터를 전달하지 않은 경우

요청 헤더

Name	Description
Authorization	Bearer + JWT Access Token

요청 파라미터

필수	Params	Type	Description
X	lastid	Integer	마지막으로 호출 된 id (미입력시 최근 id부터 출력)
O	amount	Integer	한번에 호출할 게시글 개수
X	type	String	"원정대" or "의뢰인" (미입력시 전체 조회)

요청 필드
없음

응답 필드

Field	Type	Description
type	String	"원정대" or "의뢰인"
title	String	제목
score	Integer	별점
gender	String	성별
category	String	카테고리
createdDateTime	String	작성시각
noticeId	Integer	게시글ID

요청 예시(URI, 헤더)

GET /notices?lastid=10&amount=2&type=원정대

Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiI0IiwiYXV0aCI6IlJPT...

응답 예시(JSON)

[
  {
    "type": "원정대",
    "title": "게시글111",
    "score": 76,
    "gender": "male",
    "category": "벌레",
    "createdDateTime": "2024-01-12 13:12:50",
    "noticeId": 10
  },
  {
    "type": "원정대",
    "title": "게시글222",
    "score": 93,
    "gender": "female",
    "category": "벌레",
    "createdDateTime": "2024-01-11 20:32:16",
    "noticeId": 9
  }
]

회원가입

• 신규 회원 정보를 입력받고 회원가입 요청을 보내는 기능입니다.
• 입력했던 이메일 주소로 회원인증 링크를 전송합니다.

POST /users/signup

성공: 201 Created
실패:

Code	Message	Description
400	아이디 형식 오류	아이디 조건에 부합되지 않는 경우
400	비밀번호 형식 오류	비밀번호 조건에 부합되지 않는 경우
400	이메일 형식 오류	이메일 조건에 부합되지 않는 경우

요청 헤더
없음

요청 파라미터
없음

요청 필드

Field	Type	Description
id	String	아이디
pw	String	비밀번호
email	String	이메일
nickname	String	닉네임
gender	String	성별

응답 필드

Field	Type	Description
id	String	아이디
pw	String	비밀번호
email	String	이메일
nickname	String	닉네임
gender	String	성별
userId	Integer	회원ID

요청 예시(URI, JSON)

POST /users/signup

{
  "id": "test1",
  "pw": "1q2w3e4r",
  "email": "testmail@naver.com",
  "nickname": "닉네임A",
  "gender": "male"
 }

응답 예시(JSON)

{
  "id": "test1",
  "pw": "1q2w3e4r",
  "email": "testmail@naver.com",
  "nickname": "닉네임A",
  "gender": "male"
  "userId": 1
}