Common Responses

Common Status Codes

# 성공
status code: 200

Common Exceptions

# 클라이언트 입력 예외
status code: 400

# 인증 예외
status code: 401

# 권한 예외
status code: 403

# NotFound 예외
status code: 404

# 서버 내부 예외
status code: 500

기능

회원 관련 기능

회원 가입

/v1/members
성공
request
POST /v1/members HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 157
Host: jikting.com

{
  "username" : "swm123",
  "password" : "password123!",
  "name" : "홍길동",
  "phone" : "01011112222",
  "nickname" : "닉네임",
  "gender" : "남"
}
response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 85

{
  "memberProfileId" : 1,
  "role" : "ROLE_UNCERTIFIED",
  "socialType" : "NORMAL"
}
실패
request
POST /v1/members HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 157
Host: jikting.com

{
  "username" : "swm123",
  "password" : "password123!",
  "name" : "홍길동",
  "phone" : "01011112222",
  "nickname" : "닉네임",
  "gender" : "남"
}
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 65

{
  "code" : "C002",
  "message" : "잘못된 양식입니다."
}

회원 조회

/v1/members
성공
request
GET /v1/members HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 131

{
  "nickname" : "닉네임",
  "company" : "",
  "imageUrl" : "https://cupid-images.s3.ap-northeast-2.amazonaws.com/default.png"
}
실패
request
GET /v1/members HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 76

{
  "code" : "U003",
  "message" : "사용자를 찾을 수 없습니다."
}

회원 프로필 조회

/v1/members/profile
성공
request
GET /v1/members/profile HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 844

{
  "birth" : "1996-05-10",
  "height" : 168,
  "address" : "거주지",
  "mbti" : "ENFJ",
  "smokeStatus" : "흡연",
  "drinkStatus" : "가끔 마심",
  "college" : "출신학교(선택사항 - 없을 시 빈 문자열)",
  "description" : "한줄 소개(선택사항 - 없을 시 빈 문자열)",
  "personalities" : [ "성격", "성격", "성격" ],
  "hobbies" : [ "취미", "취미", "취미" ],
  "images" : [ {
    "profileImageId" : null,
    "url" : "https://cupid-images.s3.ap-northeast-2.amazonaws.com/default.png",
    "sequence" : "MAIN"
  }, {
    "profileImageId" : null,
    "url" : "https://cupid-images.s3.ap-northeast-2.amazonaws.com/default.png",
    "sequence" : "FIRST"
  }, {
    "profileImageId" : null,
    "url" : "https://cupid-images.s3.ap-northeast-2.amazonaws.com/default.png",
    "sequence" : "SECOND"
  } ]
}
실패
request
GET /v1/members/profile HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 76

{
  "code" : "U003",
  "message" : "사용자를 찾을 수 없습니다."
}

회원 닉네임 수정

/v1/members
성공
request
PATCH /v1/members HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer null
Content-Length: 30
Host: jikting.com

{
  "nickname" : "닉네임"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
PATCH /v1/members HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer null
Content-Length: 30
Host: jikting.com

{
  "nickname" : "닉네임"
}
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 76

{
  "code" : "U003",
  "message" : "사용자를 찾을 수 없습니다."
}

회원 프로필 수정

/v1/members/profile
성공
request
POST /v1/members/profile HTTP/1.1
Content-Type: multipart/form-data;charset=UTF-8; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Authorization: Bearer null
Host: jikting.com

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=memberProfileUpdateRequest
Content-Type: application/json

{"birth":"1996-05-10","height":168,"mbti":"ENFJ","address":"거주지","college":"출신학교(선택사항 - 없을 시 빈 문자열)","smokeStatus":"흡연","drinkStatus":"가끔 마심","description":"한줄 소개(선택사항 - 없을 시 빈 문자열)","personalities":["성격1","성격2","성격3"],"hobbies":["취미1","취미2","취미3"]}
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=file; filename=image.png
Content-Type: image/png

이미지 파일
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/members/profile HTTP/1.1
Content-Type: multipart/form-data;charset=UTF-8; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Authorization: Bearer null
Host: jikting.com

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=memberProfileUpdateRequest
Content-Type: application/json

{"birth":"1996-05-10","height":168,"mbti":"ENFJ","address":"거주지","college":"출신학교(선택사항 - 없을 시 빈 문자열)","smokeStatus":"흡연","drinkStatus":"가끔 마심","description":"한줄 소개(선택사항 - 없을 시 빈 문자열)","personalities":["성격1","성격2","성격3"],"hobbies":["취미1","취미2","취미3"]}
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=file; filename=image.png
Content-Type: image/png

이미지 파일
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 76

{
  "code" : "U003",
  "message" : "사용자를 찾을 수 없습니다."
}

회원 비밀번호 수정

/v1/members/password
성공
request
PATCH /v1/members/password HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer null
Content-Length: 71
Host: jikting.com

{
  "password" : "password123!",
  "newPassword" : "새 비밀번호"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
PATCH /v1/members/password HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer null
Content-Length: 71
Host: jikting.com

{
  "password" : "password123!",
  "newPassword" : "새 비밀번호"
}
response - 회원을 찾을 수 없음
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 76

{
  "code" : "U003",
  "message" : "사용자를 찾을 수 없습니다."
}
response - 기존 비밀번호 불일치
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 98

{
  "code" : "U007",
  "message" : "아이디 또는 비밀번호가 일치하지 않습니다."
}
response - 비밀번호 양식 불일치
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 65

{
  "code" : "C002",
  "message" : "잘못된 양식입니다."
}

회원 탈퇴

/v1/members/withdraw
성공
request
POST /v1/members/withdraw HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer null
Content-Length: 33
Host: jikting.com

{
  "password" : "password123!"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
PATCH /v1/members/password HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer null
Content-Length: 71
Host: jikting.com

{
  "password" : "password123!",
  "newPassword" : "새 비밀번호"
}
response - 회원을 찾을 수 없음
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 76

{
  "code" : "U003",
  "message" : "사용자를 찾을 수 없습니다."
}
response - 비밀번호 불일치
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 98

{
  "code" : "U007",
  "message" : "아이디 또는 비밀번호가 일치하지 않습니다."
}

아이디 중복 검사

/v1/members/username/check
성공
request
POST /v1/members/username/check HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 27
Host: jikting.com

{
  "username" : "swm123"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/members/username/check HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 27
Host: jikting.com

{
  "username" : "swm123"
}
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 82

{
  "code" : "U004",
  "message" : "해당 아이디가 이미 존재합니다."
}

닉네임 중복 검사

/v1/members/nickname/check
성공
request
POST /v1/members/nickname/check HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 30
Host: jikting.com

{
  "nickname" : "닉네임"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/members/username/check HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 27
Host: jikting.com

{
  "username" : "swm123"
}
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 82

{
  "code" : "U005",
  "message" : "해당 닉네임이 이미 존재합니다."
}

전화번호 인증번호 발급

/v1/members/code
성공
request
POST /v1/members/code HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 29
Host: jikting.com

{
  "phone" : "01011112222"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/members/code HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 29
Host: jikting.com

{
  "phone" : "01011112222"
}
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 65

{
  "code" : "C002",
  "message" : "잘못된 양식입니다."
}

전화번호 인증

/v1/members/verification
성공
request
POST /v1/members/verification HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 68
Host: jikting.com

{
  "phone" : "01011112222",
  "verificationCode" : "인증번호"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/members/verification HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 68
Host: jikting.com

{
  "phone" : "01011112222",
  "verificationCode" : "인증번호"
}
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 81

{
  "code" : "C001",
  "message" : "인증번호가 일치하지 않습니다."
}

아이디 찾기 인증번호 발급

/v1/members/username/search/code
성공
request
POST /v1/members/username/search/code HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 53
Host: jikting.com

{
  "name" : "홍길동",
  "phone" : "01011112222"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/members/username/search/code HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 53
Host: jikting.com

{
  "name" : "홍길동",
  "phone" : "01011112222"
}
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 76

{
  "code" : "U003",
  "message" : "사용자를 찾을 수 없습니다."
}

아이디 찾기 인증

/v1/members/username/search/verification
성공
request
POST /v1/members/username/search/verification HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 68
Host: jikting.com

{
  "phone" : "01011112222",
  "verificationCode" : "인증번호"
}
response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 27

{
  "username" : "swm123"
}
실패
request
POST /v1/members/username/search/verification HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 68
Host: jikting.com

{
  "phone" : "01011112222",
  "verificationCode" : "인증번호"
}
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 81

{
  "code" : "C001",
  "message" : "인증번호가 일치하지 않습니다."
}

비밀번호 재설정 인증번호 발급

/v1/members/password/reset/code
성공
request
POST /v1/members/password/reset/code HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 78
Host: jikting.com

{
  "username" : "swm123",
  "name" : "홍길동",
  "phone" : "01011112222"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/members/password/reset/code HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 78
Host: jikting.com

{
  "username" : "swm123",
  "name" : "홍길동",
  "phone" : "01011112222"
}
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 76

{
  "code" : "U003",
  "message" : "사용자를 찾을 수 없습니다."
}

비밀번호 재설정 인증

/v1/members/password/reset/verification
성공
request
POST /v1/members/password/reset/verification HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 68
Host: jikting.com

{
  "phone" : "01011112222",
  "verificationCode" : "인증번호"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/members/password/reset/verification HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 68
Host: jikting.com

{
  "phone" : "01011112222",
  "verificationCode" : "인증번호"
}
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 81

{
  "code" : "C001",
  "message" : "인증번호가 일치하지 않습니다."
}

비밀번호 재설정

/v1/members/password/reset
성공
request
PATCH /v1/members/password/reset HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 58
Host: jikting.com

{
  "username" : "swm123",
  "password" : "password123!"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
PATCH /v1/members/password/reset HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 58
Host: jikting.com

{
  "username" : "swm123",
  "password" : "password123!"
}
response - 회원을 찾을 수 없음
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 76

{
  "code" : "U003",
  "message" : "사용자를 찾을 수 없습니다."
}
response - 비밀번호 양식 불일치
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 65

{
  "code" : "C002",
  "message" : "잘못된 양식입니다."
}

회사 이메일 인증번호 발급

/v1/members/company/code
성공
request
POST /v1/members/company/code HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer null
Content-Length: 34
Host: jikting.com

{
  "email" : "회사 이메일"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/members/company/code HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer null
Content-Length: 34
Host: jikting.com

{
  "email" : "회사 이메일"
}
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 65

{
  "code" : "C002",
  "message" : "잘못된 양식입니다."
}

회사 이메일 인증

/v1/members/company/verification
성공
request
POST /v1/members/company/verification HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer null
Content-Length: 73
Host: jikting.com

{
  "email" : "회사 이메일",
  "verificationCode" : "인증번호"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/members/company/verification HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer null
Content-Length: 73
Host: jikting.com

{
  "email" : "회사 이메일",
  "verificationCode" : "인증번호"
}
response - 인증번호 불일치
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 81

{
  "code" : "C001",
  "message" : "인증번호가 일치하지 않습니다."
}
response - 인증번호 만료
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 81

{
  "code" : "C010",
  "message" : "인증번호가 유효하지 않습니다."
}

회사 명함 인증

/v1/members/company/card
성공
request
POST /v1/members/company/card HTTP/1.1
Content-Type: multipart/form-data;charset=UTF-8; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Authorization: Bearer null
Host: jikting.com

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=companyVerificationRequest
Content-Type: application/json

{"company":"직장"}
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=file; filename=image.png
Content-Type: image/png

이미지 파일
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/members/company/card HTTP/1.1
Content-Type: multipart/form-data;charset=UTF-8; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Authorization: Bearer null
Host: jikting.com

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=companyVerificationRequest
Content-Type: application/json

{"company":"직장"}
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=file; filename=image.png
Content-Type: image/png

이미지 파일
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--
response - 파일 형식 미지원
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 85

{
  "code" : "C004",
  "message" : "지원하지 않는 파일 확장자입니다."
}
response - 파일 크기 미지원
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 82

{
  "code" : "C005",
  "message" : "지원하지 않는 파일 크기입니다."
}

로그인

/v1/members/login
성공
request
POST /v1/members/login HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 58
Host: jikting.com

{
  "username" : "swm123",
  "password" : "password123!"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/members/login HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 58
Host: jikting.com

{
  "username" : "swm123",
  "password" : "password123!"
}
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 98

{
  "code" : "U007",
  "message" : "아이디 또는 비밀번호가 일치하지 않습니다."
}

회사 차단

/v1/members/company/block
성공
request
POST /v1/members/company/block HTTP/1.1
Host: jikting.com
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/members/company/block HTTP/1.1
Host: jikting.com
response
HTTP/1.1 403 Forbidden
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 75

{
  "code" : "U002",
  "message" : "권한이 없는 사용자입니다."
}

회원 신고

/v1/members/report/{reportMemberProfileId}
성공
request
POST /v1/members/report/1 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer null
Content-Length: 33
Host: jikting.com

{
  "message" : "신고 내용"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/members/report/1 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer null
Content-Length: 33
Host: jikting.com

{
  "message" : "신고 내용"
}
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 76

{
  "code" : "U003",
  "message" : "사용자를 찾을 수 없습니다."
}

팀 관련 기능

팀 등록

/v1/teams
성공
request
POST /v1/teams HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer null
Content-Length: 119
Host: jikting.com

{
  "description" : "한줄 소개",
  "memberCount" : 0,
  "keywords" : [ "키워드1", "키워드2", "키워드3" ]
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/teams HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer null
Content-Length: 119
Host: jikting.com

{
  "description" : "한줄 소개",
  "memberCount" : 0,
  "keywords" : [ "키워드1", "키워드2", "키워드3" ]
}
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 65

{
  "code" : "C002",
  "message" : "잘못된 양식입니다."
}

팀 참여

/v1/teams/{teamId}/attend
성공
request
POST /v1/teams/1/attend HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/teams/1/attend HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 70

{
  "code" : "T001",
  "message" : "팀을 찾을 수 없습니다."
}

팀 조회

/v1/teams/{teamId}
성공
request
GET /v1/teams HTTP/1.1
Host: jikting.com
response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 1284

{
  "name" : "팀명",
  "description" : "한줄 소개",
  "invitationUrl" : "https://jikting.com/invite?team={teamId}",
  "keywords" : [ "키워드", "키워드", "키워드" ],
  "members" : [ {
    "nickname" : "닉네임",
    "image" : "https://cupid-images.s3.ap-northeast-2.amazonaws.com/default.png",
    "age" : 28,
    "mbti" : "ENFJ",
    "address" : "거주지",
    "type" : "UNCERTIFIED",
    "height" : 189,
    "description" : "한줄 소개",
    "company" : "회사",
    "smokeStatus" : "흡연",
    "drinkStatus" : "가끔 마심"
  }, {
    "nickname" : "닉네임",
    "image" : "https://cupid-images.s3.ap-northeast-2.amazonaws.com/default.png",
    "age" : 28,
    "mbti" : "ENFJ",
    "address" : "거주지",
    "type" : "UNCERTIFIED",
    "height" : 189,
    "description" : "한줄 소개",
    "company" : "회사",
    "smokeStatus" : "흡연",
    "drinkStatus" : "가끔 마심"
  }, {
    "nickname" : "닉네임",
    "image" : "https://cupid-images.s3.ap-northeast-2.amazonaws.com/default.png",
    "age" : 28,
    "mbti" : "ENFJ",
    "address" : "거주지",
    "type" : "UNCERTIFIED",
    "height" : 189,
    "description" : "한줄 소개",
    "company" : "회사",
    "smokeStatus" : "흡연",
    "drinkStatus" : "가끔 마심"
  } ]
}
실패
request
GET /v1/teams HTTP/1.1
Host: jikting.com
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 70

{
  "code" : "T001",
  "message" : "팀을 찾을 수 없습니다."
}

팀 수정

/v1/teams/{teamId}
성공
request
PATCH /v1/teams/1 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 98
Host: jikting.com

{
  "description" : "한줄 소개",
  "keywords" : [ "키워드1", "키워드2", "키워드3" ]
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
PATCH /v1/teams/1 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 98
Host: jikting.com

{
  "description" : "한줄 소개",
  "keywords" : [ "키워드1", "키워드2", "키워드3" ]
}
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 65

{
  "code" : "C002",
  "message" : "잘못된 양식입니다."
}

팀 삭제

/v1/teams/{teamId}
성공
request
DELETE /v1/teams/1 HTTP/1.1
Host: jikting.com
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
DELETE /v1/teams/1 HTTP/1.1
Host: jikting.com
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 70

{
  "code" : "T001",
  "message" : "팀을 찾을 수 없습니다."
}

팀원 삭제

/v1/teams/{teamId}/members/{memberProfileId}
성공
request
DELETE /v1/teams/1/members/1 HTTP/1.1
Host: jikting.com
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
DELETE /v1/teams/1/members/1 HTTP/1.1
Host: jikting.com
response - 팀을 찾을 수 없음
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 70

{
  "code" : "T001",
  "message" : "팀을 찾을 수 없습니다."
}
response - 회원을 찾을 수 없음
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 76

{
  "code" : "U003",
  "message" : "사용자를 찾을 수 없습니다."
}

추천 관련 기능

추천 팀 조회

/v1/recommends
성공
request
GET /v1/recommends HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 1451

[ {
  "recommendId" : 1,
  "name" : "이름",
  "description" : "소개",
  "personalities" : [ "성격" ],
  "members" : [ {
    "nickname" : "닉네임",
    "images" : [ ],
    "age" : 27,
    "mbti" : "ENFJ",
    "address" : "거주지",
    "company" : "회사",
    "smokeStatus" : "흡연",
    "drinkStatus" : "가끔 마심",
    "height" : 180,
    "description" : "소개",
    "personalities" : [ "성격" ],
    "hobbies" : [ "취미" ],
    "college" : "대학"
  } ]
}, {
  "recommendId" : 1,
  "name" : "이름",
  "description" : "소개",
  "personalities" : [ "성격" ],
  "members" : [ {
    "nickname" : "닉네임",
    "images" : [ ],
    "age" : 27,
    "mbti" : "ENFJ",
    "address" : "거주지",
    "company" : "회사",
    "smokeStatus" : "흡연",
    "drinkStatus" : "가끔 마심",
    "height" : 180,
    "description" : "소개",
    "personalities" : [ "성격" ],
    "hobbies" : [ "취미" ],
    "college" : "대학"
  } ]
}, {
  "recommendId" : 1,
  "name" : "이름",
  "description" : "소개",
  "personalities" : [ "성격" ],
  "members" : [ {
    "nickname" : "닉네임",
    "images" : [ ],
    "age" : 27,
    "mbti" : "ENFJ",
    "address" : "거주지",
    "company" : "회사",
    "smokeStatus" : "흡연",
    "drinkStatus" : "가끔 마심",
    "height" : 180,
    "description" : "소개",
    "personalities" : [ "성격" ],
    "hobbies" : [ "취미" ],
    "college" : "대학"
  } ]
} ]
실패
request
GET /v1/recommends HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 73

{
  "code" : "R001",
  "message" : "추천을 찾을 수 없습니다."
}

호감 보내기

/v1/recommends/{recommendId}/like
성공
request
POST /v1/recommends/1/like HTTP/1.1
Host: jikting.com
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/recommends/1/like HTTP/1.1
Host: jikting.com
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 73

{
  "code" : "R001",
  "message" : "추천을 찾을 수 없습니다."
}

호감 넘기기

/v1/recommends/{recommendId}/pass
성공
request
POST /v1/recommends/1/pass HTTP/1.1
Host: jikting.com
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/recommends/1/pass HTTP/1.1
Host: jikting.com
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 73

{
  "code" : "R001",
  "message" : "추천을 찾을 수 없습니다."
}

호감 관련 기능

받은 호감 목록 조회

/v1/likes/received
성공
request
GET /v1/likes/received HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 414

[ {
  "likeId" : 1,
  "name" : "팀명",
  "description" : "소개",
  "keywords" : [ "성격", "성격", "성격" ],
  "imageUrls" : [ "https://cupid-images.s3.ap-northeast-2.amazonaws.com/default.png" ]
}, {
  "likeId" : 1,
  "name" : "팀명",
  "description" : "소개",
  "keywords" : [ "성격", "성격", "성격" ],
  "imageUrls" : [ "https://cupid-images.s3.ap-northeast-2.amazonaws.com/default.png" ]
} ]
실패
request
GET /v1/likes/received HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 70

{
  "code" : "T001",
  "message" : "팀을 찾을 수 없습니다."
}

보낸 호감 목록 조회

/v1/likes/sent
성공
request
GET /v1/likes/sent HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 414

[ {
  "likeId" : 1,
  "name" : "팀명",
  "description" : "소개",
  "keywords" : [ "성격", "성격", "성격" ],
  "imageUrls" : [ "https://cupid-images.s3.ap-northeast-2.amazonaws.com/default.png" ]
}, {
  "likeId" : 1,
  "name" : "팀명",
  "description" : "소개",
  "keywords" : [ "성격", "성격", "성격" ],
  "imageUrls" : [ "https://cupid-images.s3.ap-northeast-2.amazonaws.com/default.png" ]
} ]
실패
request
GET /v1/likes/sent HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 70

{
  "code" : "T001",
  "message" : "팀을 찾을 수 없습니다."
}

받은 호감 수락

/v1/likes/{likeId}/accept
성공
request
POST /v1/likes/1/accept HTTP/1.1
Host: jikting.com
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/likes/1/accept HTTP/1.1
Host: jikting.com
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 70

{
  "code" : "T001",
  "message" : "팀을 찾을 수 없습니다."
}

팀 상세 조회

/v1/likes/{likeId}
성공
request
GET /v1/likes/1/received HTTP/1.1
Host: jikting.com
response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 537

{
  "likeId" : 1,
  "teamName" : "팀명",
  "keywords" : [ "성격", "성격", "성격" ],
  "members" : [ {
    "nickname" : "닉네임",
    "image" : "https://cupid-images.s3.ap-northeast-2.amazonaws.com/default.png",
    "age" : 28,
    "mbti" : "ENFJ",
    "address" : "거주지",
    "company" : "회사",
    "smokeStatus" : "SMOKING",
    "drinkStatus" : "OFTEN",
    "height" : 180,
    "description" : "소개",
    "keywords" : [ "성격", "성격", "성격", "취미", "취미", "취미" ],
    "college" : "대학"
  } ]
}
실패
request
GET /v1/likes/1/received HTTP/1.1
Host: jikting.com
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 70

{
  "code" : "T001",
  "message" : "팀을 찾을 수 없습니다."
}

받은 호감 거절

/v1/likes/{likeId}/reject
성공
request
POST /v1/likes/1/reject HTTP/1.1
Host: jikting.com
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/likes/1/reject HTTP/1.1
Host: jikting.com
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 70

{
  "code" : "T001",
  "message" : "팀을 찾을 수 없습니다."
}

채팅 관련 기능

채팅 목록 조회

/v1/chattings
성공
request
GET /v1/chattings/rooms HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 518

[ {
  "chattingRoomId" : 1,
  "opposingTeamName" : "팀이름",
  "lastMessage" : "메시지",
  "images" : [ "이미지 주소", "이미지 주소", "이미지 주소" ]
}, {
  "chattingRoomId" : 1,
  "opposingTeamName" : "팀이름",
  "lastMessage" : "메시지",
  "images" : [ "이미지 주소", "이미지 주소", "이미지 주소" ]
}, {
  "chattingRoomId" : 1,
  "opposingTeamName" : "팀이름",
  "lastMessage" : "메시지",
  "images" : [ "이미지 주소", "이미지 주소", "이미지 주소" ]
} ]

채팅방 입장

/v1/chattings/{chattingRoomId}
성공
request
GET /v1/chattings/rooms/1 HTTP/1.1
Host: jikting.com
response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 602

{
  "name" : "팀이름",
  "description" : "팀소개",
  "keywords" : [ "키워드1", "키워드2", "키워드3" ],
  "members" : [ {
    "memberProfileId" : null,
    "nickname" : "닉네임",
    "image" : "https://cupid-images.s3.ap-northeast-2.amazonaws.com/default.png"
  }, {
    "memberProfileId" : null,
    "nickname" : "닉네임",
    "image" : "https://cupid-images.s3.ap-northeast-2.amazonaws.com/default.png"
  }, {
    "memberProfileId" : null,
    "nickname" : "닉네임",
    "image" : "https://cupid-images.s3.ap-northeast-2.amazonaws.com/default.png"
  } ],
  "chattings" : null
}
실패
request
GET /v1/chattings/rooms/1 HTTP/1.1
Host: jikting.com
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 76

{
  "code" : "C001",
  "message" : "채팅방을 찾을 수 없습니다."
}

미팅 확정

/v1/chattings/{chattingId}/confirm
성공
request
POST /v1/chattings/rooms/1/confirm HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 87
Host: jikting.com

{
  "meetingId" : 1,
  "place" : "미팅장소",
  "schedule" : "2023-06-30T18:00:00"
}
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
response - 잘못된 양식
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 65

{
  "code" : "C002",
  "message" : "잘못된 양식입니다."
}
response - 채팅방 정보를 찾을 수 없음
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 76

{
  "code" : "C001",
  "message" : "채팅방을 찾을 수 없습니다."
}

번개팅 관련 기능

번개팅 목록 조회

/v1/instant-meetings
성공
request
GET /v1/instant-meetings HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 264

[ {
  "instantMeetingId" : 1,
  "schedule" : "2023-06-30T18:00:00",
  "place" : "장소",
  "memberCount" : 3,
  "attend" : false
}, {
  "instantMeetingId" : 1,
  "schedule" : "2023-06-30T18:00:00",
  "place" : "장소",
  "memberCount" : 3,
  "attend" : false
} ]

번개팅 참여

/v1/instant-meetings/{instantMeetingId}
성공
request
POST /v1/instant-meetings/1 HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 200 OK
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
실패
request
POST /v1/instant-meetings/1 HTTP/1.1
Authorization: Bearer null
Host: jikting.com
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Content-Length: 88

{
  "code" : "I002",
  "message" : "이미 번개팅 모집이 완료되었습니다."
}