ReSeller API guide

USER API

1. CREATE USER

회원가입

1. Success

request-fields

Path Type Description

Path	Type	Description
`email`	`String`	The user’s email address
`password`	`String`	The user’s password
`nickname`	`String`	The user’s nickname
`phone`	`String`	The user’s phone

email

String

The user’s email address

password

String

The user’s password

nickname

String

The user’s nickname

phone

String

The user’s phone

Example request

POST /users HTTP/1.1
Content-Type: application/json
Content-Length: 96
Host: localhost:8080

{"nickname":"hong43ok","email":"hong43ok@gmail.com","password":"test1234","phone":"01012345678"}

Example response

HTTP/1.1 201 Created

이메일 중복 검사

1. Success

Table 1. /users/user-emails/{email}/exists
Parameter	Description
`email`	이메일

Example request

GET /users/user-emails/hong43ok@gmail.com/exists HTTP/1.1
Host: localhost:8080

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 5

false

2. Fail

Table 2. /users/user-emails/{email}/exists
Parameter	Description
`email`	이메일

Example request

GET /users/user-emails/hong43ok@gmail.com/exists HTTP/1.1
Host: localhost:8080

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 4

true

중복 검사 통과시 false , 중복 검사 실패시 true 리턴

닉네임 중복 검사

1. Success

Table 3. /users/user-nicknames/{nickname}/exists
Parameter	Description
`nickname`	닉네임

Example request

GET /users/user-nicknames/hong43ok/exists HTTP/1.1
Host: localhost:8080

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 5

false

2. Fail

Table 4. /users/user-nicknames/{nickname}/exists
Parameter	Description
`nickname`	닉네임

Example request

GET /users/user-nicknames/hong43ok/exists HTTP/1.1
Host: localhost:8080

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 4

true

중복 검사 통과시 false , 중복 검사 실패시 true 리턴

이메일 인증(토큰)

1. Success : Authentication Successful

request-parameters

Parameter Description

Parameter	Description
`token`	회원가입시 발송되는 랜덤 토큰
`email`	회원가입시 입력한 이메일

token

회원가입시 발송되는 랜덤 토큰

email

회원가입시 입력한 이메일

Example request

GET /users/email-check-token?token=0987dfab-4b6f-4505-b10a-a2257b427119&email=hong43ok%40gmail.com HTTP/1.1
Host: localhost:8080

Example response

HTTP/1.1 200 OK

2. login / logout

Path	Type	Description
`email`	`String`	login ID (email)
`password`	`String`	password

로그아웃

1. Success

Example request

DELETE /users/logout HTTP/1.1
Host: localhost:8080

Example response

HTTP/1.1 200 OK

3. 비밀번호 찾기

회원 리소스

1. successful get resource

Table 5. /users/find/{email}
Parameter	Description
`email`	이메일

Example request

GET /users/find/hong43ok@gmail.com HTTP/1.1
Host: localhost:8080

Example response

HTTP/1.1 200 OK
Content-Disposition: inline;filename=f.txt
Content-Type: application/json
Content-Length: 52

{"email":"hong43ok@gmail.com","phone":"01012345678"}

이메일 인증

1. Send Email

request-fields

Path Type Description

Path	Type	Description
`email`	`String`	인증번호를 받을 이메일

email

String

인증번호를 받을 이메일

Example request

POST /users/email-certification/sends HTTP/1.1
Content-Type: application/json
Content-Length: 57
Host: localhost:8080

{"email":"hong43ok@gmail.com","certificationNumber":null}

Example response

HTTP/1.1 201 Created

2. resend

Example request

POST /users/resend-email-token HTTP/1.1
Host: localhost:8080

Example response

HTTP/1.1 200 OK

회원가입시 입력한 이메일로 인증 토큰이 전송됩니다. 해당 토큰은 24시간동안 유효하며, 24시간이 경과되었을 경우 토큰 재전송 요청을 진행해야 합니다.

2. Success : Authentication Successful

request-fields

Path Type Description

Path	Type	Description
`email`	`String`	비밀번호 찾기를 원하는 이메일
`certificationNumber`	`String`	사용자가 입력한 인증번호

email

String

비밀번호 찾기를 원하는 이메일

certificationNumber

String

사용자가 입력한 인증번호

Example request

POST /users/email-certification/confirms HTTP/1.1
Content-Type: application/json
Content-Length: 61
Host: localhost:8080

{"email":"hong43ok@gmail.com","certificationNumber":"123456"}

Example response

HTTP/1.1 200 OK

비밀번호 분실시 이메일 또는 휴대폰중 하나를 선택하여 인증을 진행한 후 비밀번호 변경 가능.
인증 번호는 10분동안 유효하며, 10분이 경과되면 자동으로 Redis 메모리에서 삭제됩니다.

4. 회원 정보 수정

비밀번호 변경

1. Success

request-fields

Path Type Description

Path	Type	Description
`email`	`String`	비밀번호 변경을 원하는 회원 ID(email
`passwordAfter`	`String`	변경할 비밀번호
`passwordBefore`	`String`	이전 비밀번호

email

String

비밀번호 변경을 원하는 회원 ID(email

passwordAfter

String

변경할 비밀번호

passwordBefore

String

이전 비밀번호

Example request

PATCH /users/password HTTP/1.1
Content-Type: application/json
Content-Length: 93
Host: localhost:8080

{"email":"hong43ok@gmail.com","passwordAfter":"test12345","passwordBefore":"newPassword1234"}

Example response

HTTP/1.1 200 OK

환급 계좌 설정

1. get resource

Example request

GET /users/account HTTP/1.1
Content-Type: application/json
Host: localhost:8080

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 68

{"bankName":"국민","accountNumber":"1234","depositor":"홍정완"}

response-fields

Path Type Description

Path	Type	Description
`bankName`	`String`	은행명
`accountNumber`	`String`	계좌 번호
`depositor`	`String`	예금주

bankName

String

은행명

accountNumber

String

계좌 번호

depositor

String

예금주

2. Successful : Modification

request-fields

Path Type Description

Path	Type	Description
`bankName`	`String`	은행명
`accountNumber`	`String`	계좌 번호
`depositor`	`String`	예금주

bankName

String

은행명

accountNumber

String

계좌 번호

depositor

String

예금주

Example request

PATCH /users/account HTTP/1.1
Content-Type: application/json
Content-Length: 68
Host: localhost:8080

{"bankName":"국민","accountNumber":"1234","depositor":"홍정완"}

Example response

HTTP/1.1 200 OK

주소록 설정

1. Successful : add

request-fields

Path Type Description

Path	Type	Description
`addressName`	`String`	주소록 이름
`roadNameAddress`	`String`	도로명 주소
`detailedAddress`	`String`	상세 주소
`postalCode`	`String`	우편번호

addressName

String

주소록 이름

roadNameAddress

String

도로명 주소

detailedAddress

String

상세 주소

postalCode

String

우편번호

Example request

POST /users/addressBook HTTP/1.1
Content-Type: application/json
Content-Length: 120
Host: localhost:8080

{"id":1,"addressName":"회사","roadNameAddress":"회사로 123","detailedAddress":"456동 123호","postalCode":"23456"}

Example response

HTTP/1.1 200 OK

2. Successful : delete

request-fields

Path Type Description

Path	Type	Description
`id`	`Number`	삭제할 주소의 ID[PK]

id

Number

삭제할 주소의 ID[PK]

Example request

DELETE /users/addressBook HTTP/1.1
Content-Type: application/json
Content-Length: 8
Host: localhost:8080

{"id":2}

Example response

HTTP/1.1 200 OK

3. Successful : Modification

request-fields

Path Type Description

Path	Type	Description
`id`	`Number`	ID
`addressName`	`String`	주소록 이름
`roadNameAddress`	`String`	도로명 주소
`detailedAddress`	`String`	상세 주소
`postalCode`	`String`	우편번호

id

Number

addressName

String

주소록 이름

roadNameAddress

String

도로명 주소

detailedAddress

String

상세 주소

postalCode

String

우편번호

Example request

PATCH /users/addressBook HTTP/1.1
Content-Type: application/json
Content-Length: 116
Host: localhost:8080

{"id":1,"addressName":"학교","roadNameAddress":"경기로","detailedAddress":"111동 112호","postalCode":"12346"}

Example response

HTTP/1.1 200 OK

5. 마이페이지

1. Success : get myInfo resource

Example request

GET /users/myInfo HTTP/1.1
Content-Type: application/json
Host: localhost:8080

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 95

{"email":"hong43ok@gmail.com","nickname":"hong43ok","phone":"01012345678","userLevel":"UNAUTH"}

response-fields

Path Type Description

Path	Type	Description
`email`	`String`	회원 이메일
`nickname`	`String`	회원 닉네임
`phone`	`String`	회원 휴대폰 번호
`userLevel`	`String`	이메일 인증 여부

email

String

회원 이메일

nickname

String

회원 닉네임

phone

String

회원 휴대폰 번호

userLevel

String

이메일 인증 여부

현재 로그인되어있는 사용자의 myInfo 리소스를 가져옵니다.

BRAND API

1. 브랜드 조회

특정 브랜드 조회

response-fields

Path Type Description

Path	Type	Description
`id`	`Number`	브랜드 ID
`nameKor`	`String`	브랜드 한글명
`nameEng`	`String`	브랜드 영문명
`originImagePath`	`String`	브랜드 원본 이미지 경로
`thumbnailImagePath`	`String`	브랜드 썸네일 이미지 경로

id

Number

브랜드 ID

nameKor

String

브랜드 한글명

nameEng

String

브랜드 영문명

originImagePath

String

브랜드 원본 이미지 경로

thumbnailImagePath

String

브랜드 썸네일 이미지 경로

Example request

GET /brands/1 HTTP/1.1
Accept: application/json
Host: localhost:8080

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 337

{"id":1,"nameKor":"브랜드 생성","nameEng":"Brand Create Test","originImagePath":"https://hongjungwan-brands-origin-temp.s3.ap-northeast-2.amazonaws.com/9a9cec61-4647-4cf5-968b-cc0e9a946730.jpg","thumbnailImagePath":"https://hongjungwan-brands-thumbnail-temp.s3.ap-northeast-2.amazonaws.com/9a9cec61-4647-4cf5-968b-cc0e9a946730.jpg"}

브랜드 전체 조회

response-fields

Path Type Description

Path	Type	Description
`[]`	`Array`	브랜드 정보 배열
`[].id`	`Number`	브랜드 ID
`[].nameKor`	`String`	브랜드 한글명
`[].nameEng`	`String`	브랜드 영문명
`[].originImagePath`	`String`	브랜드 원본 이미지 경로
`[].thumbnailImagePath`	`String`	브랜드 썸네일 이미지 경로

[]

Array

브랜드 정보 배열

[].id

Number

브랜드 ID

[].nameKor

String

브랜드 한글명

[].nameEng

String

브랜드 영문명

[].originImagePath

String

브랜드 원본 이미지 경로

[].thumbnailImagePath

String

브랜드 썸네일 이미지 경로

Example request

GET /brands HTTP/1.1
Accept: application/json
Host: localhost:8080

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 679

[{"id":1,"nameKor":"브랜드 생성","nameEng":"Brand Create Test","originImagePath":"https://hongjungwan-brands-origin-temp.s3.ap-northeast-2.amazonaws.com/9a9cec61-4647-4cf5-968b-cc0e9a946730.jpg","thumbnailImagePath":"https://hongjungwan-brands-thumbnail-temp.s3.ap-northeast-2.amazonaws.com/9a9cec61-4647-4cf5-968b-cc0e9a946730.jpg"},{"id":2,"nameKor":"브랜드 생성2","nameEng":"Brand Create Test2","originImagePath":"https://hongjungwan-brands-origin-temp.s3.ap-northeast-2.amazonaws.com/9a9cec61-4647-4cf5-968b-cc0e9a946730.jpg","thumbnailImagePath":"https://hongjungwan-brands-thumbnail-temp.s3.ap-northeast-2.amazonaws.com/9a9cec61-4647-4cf5-968b-cc0e9a946730.jpg"}]

2. 브랜드 생성

request-fields

Path Type Description

Path	Type	Description
`nameKor`	`String`	저장할 브랜드의 한글명
`nameEng`	`String`	저장할 브랜드의 영문명

nameKor

String

저장할 브랜드의 한글명

nameEng

String

저장할 브랜드의 영문명

request-parts (Optional)

Part Description

Part	Description
`brandImage`	저장할 브랜드의 이미지 파일

brandImage

저장할 브랜드의 이미지 파일

Example request

POST /brands HTTP/1.1
Content-Type: multipart/form-data;charset=utf-8; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Accept: application/json
Host: localhost:8080

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

{"nameKor":"저장","nameEng":"Save Test","originImagePath":null,"thumbnailImagePath":null}
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=brandImage; filename=brandImage
Content-Type: image/png

sample
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--

Example response

HTTP/1.1 201 Created

3. 브랜드 수정

request-fields

Path Type Description

Path	Type	Description
`nameKor`	`String`	수정할 브랜드의 한글명
`nameEng`	`String`	수정할 브랜드의 영문명
`originImagePath`	`String`	기존 브랜드 원본 이미지 경로(null이라면 기존 이미지 삭제)

nameKor

String

수정할 브랜드의 한글명

nameEng

String

수정할 브랜드의 영문명

originImagePath

String

기존 브랜드 원본 이미지 경로(null이라면 기존 이미지 삭제)

Example request

PATCH /brands/1 HTTP/1.1
Content-Type: multipart/form-data;charset=utf-8; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Accept: application/json
Host: localhost:8080

Example response

HTTP/1.1 200 OK

4. 브랜드 삭제

path-parameters

Table 6. /brands/{id}
Parameter	Description
`id`	삭제할 브랜드의 ID

Example request

DELETE /brands/1 HTTP/1.1
Host: localhost:8080

Example response

HTTP/1.1 200 OK

PRODUCT API

1. 상품 조회

상품 정보 조회

path-parameters

Table 7. /products/{id}
Parameter	Description
`id`	조회할 상품의 ID

response-fields

Path Type Description

Path	Type	Description
`id`	`Number`	조회한 상품의 ID
`nameKor`	`String`	조회한 상품의 한글명
`nameEng`	`String`	조회한 상품의 영문명
`modelNumber`	`String`	조회한 상품의 모델 넘버
`color`	`String`	조회한 상품의 색상
`releaseDate`	`String`	조회한 상품의 출시일
`releasePrice`	`Number`	조회한 상품의 출시가
`currency`	`String`	조회한 상품의 발매 통화
`sizeClassification`	`String`	조회한 상품의 사이즈 분류
`sizeUnit`	`String`	조회한 상품의 사이즈 단위
`minSize`	`Number`	조회한 상품의 최소 사이즈
`maxSize`	`Number`	조회한 상품의 최대 사이즈
`sizeGap`	`Number`	조회한 상품의 사이즈 간격
`brand`	`Object`	조회한 상품의 브랜드
`resizedImagePath`	`String`	조회한 상품의 이미지 경로
`saleBids.[].tradeId`	`Number`	판매 입찰 ID
`saleBids.[].productId`	`Number`	판매 입찰 productID
`saleBids.[].productSize`	`Number`	판매 입찰 물품 사이즈
`saleBids.[].price`	`Number`	판매 입찰 물품 가격
`purchaseBids.[].tradeId`	`Number`	구매 입찰 ID
`purchaseBids.[].productId`	`Number`	구매 입찰 productId
`purchaseBids.[].productSize`	`Number`	구매 입찰 물품 사이즈
`purchaseBids.[].price`	`Number`	구매 입찰 물품 가격
`tradeCompleteInfos.[].productSize`	`Number`	완료된 거래의 물품 사이즈
`tradeCompleteInfos.[].price`	`Number`	완료된 거래의 물품 가격
`tradeCompleteInfos.[].completeTime`	`String`	거래 완료 시간

id

Number

조회한 상품의 ID

nameKor

String

조회한 상품의 한글명

nameEng

String

조회한 상품의 영문명

modelNumber

String

조회한 상품의 모델 넘버

color

String

조회한 상품의 색상

releaseDate

String

조회한 상품의 출시일

releasePrice

Number

조회한 상품의 출시가

currency

String

조회한 상품의 발매 통화

sizeClassification

String

조회한 상품의 사이즈 분류

sizeUnit

String

조회한 상품의 사이즈 단위

minSize

Number

조회한 상품의 최소 사이즈

maxSize

Number

조회한 상품의 최대 사이즈

sizeGap

Number

조회한 상품의 사이즈 간격

brand

Object

조회한 상품의 브랜드

resizedImagePath

String

조회한 상품의 이미지 경로

saleBids.[].tradeId

Number

판매 입찰 ID

saleBids.[].productId

Number

판매 입찰 productID

saleBids.[].productSize

Number

판매 입찰 물품 사이즈

saleBids.[].price

Number

판매 입찰 물품 가격

purchaseBids.[].tradeId

Number

구매 입찰 ID

purchaseBids.[].productId

Number

구매 입찰 productId

purchaseBids.[].productSize

Number

구매 입찰 물품 사이즈

purchaseBids.[].price

Number

구매 입찰 물품 가격

tradeCompleteInfos.[].productSize

Number

완료된 거래의 물품 사이즈

tradeCompleteInfos.[].price

Number

완료된 거래의 물품 가격

tradeCompleteInfos.[].completeTime

String

거래 완료 시간

Example request

GET /products/1 HTTP/1.1
Accept: application/json
Host: localhost:8080

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 983

{"id":1,"nameKor":"덩크 로우","nameEng":"Dunk Low","modelNumber":"DD1391-100","color":"WHITE/BLACK","releaseDate":"2022-11-12","releasePrice":119000,"currency":"KRW","sizeClassification":"MENS","sizeUnit":"MM","minSize":240.0,"maxSize":320.0,"sizeGap":5.0,"resizedImagePath":"https://hongjungwan-brands-origin-temp.s3.ap-northeast-2.amazonaws.com/9a9cec61-4647-4cf5-968b-cc0e9a946730.jpg","brand":{"id":null,"nameKor":"나이키","nameEng":"Nike","originImagePath":"https://hongjungwan-brands-origin-temp.s3.ap-northeast-2.amazonaws.com/9a9cec61-4647-4cf5-968b-cc0e9a946730.jpg","thumbnailImagePath":"https://hongjungwan-brands-thumbnail-temp.s3.ap-northeast-2.amazonaws.com/9a9cec61-4647-4cf5-968b-cc0e9a946730.jpg"},"saleBids":[{"tradeId":5,"productId":1,"productSize":260.0,"price":200000}],"purchaseBids":[{"tradeId":5,"productId":1,"productSize":260.0,"price":300000}],"tradeCompleteInfos":[{"productSize":280.0,"price":300000,"completeTime":"2022-11-12T10:11:11.4975403"}]}

조건 별 상품 전체 조회

request-parameters

Parameter Description

Parameter	Description
`brandId`	조회할 상품 썸네일의 브랜드 ID
`keyword`	조회할 상품의 검색 키워드
`orderStandard`	조회할 상품의 정렬 조건

brandId

조회할 상품 썸네일의 브랜드 ID

keyword

조회할 상품의 검색 키워드

orderStandard

조회할 상품의 정렬 조건

response-fields

Path Type Description

Path	Type	Description
`content.[].id`	`Number`	조회한 상품의 ID
`content.[].productThumbnailImagePath`	`String`	조회한 상품의 썸네일 이미지 경로
`content.[].brandThumbnailImagePath`	`String`	조회한 상품의 브랜드 썸네일 이미지 경로
`content.[].nameKor`	`String`	조회한 상품의 한글명
`content.[].nameEng`	`String`	조회한 상품의 영문명
`content.[].lowestPrice`	`Number`	조회한 상품의 즉시 구매 최저가

content.[].id

Number

조회한 상품의 ID

content.[].productThumbnailImagePath

String

조회한 상품의 썸네일 이미지 경로

content.[].brandThumbnailImagePath

String

조회한 상품의 브랜드 썸네일 이미지 경로

content.[].nameKor

String

조회한 상품의 한글명

content.[].nameEng

String

조회한 상품의 영문명

content.[].lowestPrice

Number

조회한 상품의 즉시 구매 최저가

Example request

GET /products?brandId=1&keyword=ka&orderStandard=LOW_PRICE HTTP/1.1
Accept: application/json
Host: localhost:8080

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 661

{"content":[{"id":99,"productThumbnailImagePath":"https://hongjungwan-product-origin-temp.s3.ap-northeast-2.amazonaws.com/ec6e5843-8776-4c60-8132-6283b31c18c7.jpg","brandThumbnailImagePath":"https://hongjungwan-brands-origin-temp.s3.ap-northeast-2.amazonaws.com/9a9cec61-4647-4cf5-968b-cc0e9a946730.jpg","nameKor":"맥","nameEng":"Mac","lowestPrice":500000}],"pageable":{"sort":{"sorted":false,"unsorted":true,"empty":true},"offset":0,"pageSize":10,"pageNumber":0,"paged":true,"unpaged":false},"totalPages":1,"totalElements":1,"last":true,"size":10,"number":0,"sort":{"sorted":false,"unsorted":true,"empty":true},"numberOfElements":1,"first":true,"empty":false}

상품 정렬 기준 조회

response-fields

Path Type Description

Path	Type	Description
`[]`	`Array`	상품의 정렬 기준 목록

[]

Array

상품의 정렬 기준 목록

Example request

GET /products/order-standards HTTP/1.1
Host: localhost:8080

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 41

["LOW_PRICE","HIGH_PRICE","RELEASE_DATE"]

2. 상품 추가

request-fields

Path Type Description

Path	Type	Description
`nameKor`	`String`	저장할 상품의 한글명
`nameEng`	`String`	저장할 상품의 영문명
`modelNumber`	`String`	저장할 상품의 모델 넘버
`color`	`String`	저장할 상품의 색상
`releaseDate`	`String`	저장할 상품의 발매일
`releasePrice`	`Number`	저장할 상품의 발매가
`currency`	`String`	저장할 상품의 발매 통화
`sizeClassification`	`String`	저장할 상품의 사이즈 분류
`sizeUnit`	`String`	저장할 상품의 사이즈 단위
`minSize`	`Number`	저장할 상품의 최소 사이즈
`maxSize`	`Number`	저장할 상품의 최대 사이즈
`sizeGap`	`Number`	저장할 상품의 사이즈 간격
`brand`	`Object`	저장할 상품의 브랜드

nameKor

String

저장할 상품의 한글명

nameEng

String

저장할 상품의 영문명

modelNumber

String

저장할 상품의 모델 넘버

color

String

저장할 상품의 색상

releaseDate

String

저장할 상품의 발매일

releasePrice

Number

저장할 상품의 발매가

currency

String

저장할 상품의 발매 통화

sizeClassification

String

저장할 상품의 사이즈 분류

sizeUnit

String

저장할 상품의 사이즈 단위

minSize

Number

저장할 상품의 최소 사이즈

maxSize

Number

저장할 상품의 최대 사이즈

sizeGap

Number

저장할 상품의 사이즈 간격

brand

Object

저장할 상품의 브랜드

Example request

POST /products HTTP/1.1
Content-Type: multipart/form-data;charset=utf-8; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Accept: application/json
Host: localhost:8080

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

{"nameKor":"덩크 로우","nameEng":"Dunk Low","modelNumber":"DD1391-100","color":"WHITE/BLACK","releaseDate":"2022-11-12","releasePrice":119000,"currency":"KRW","sizeClassification":"MENS","sizeUnit":"MM","minSize":240.0,"maxSize":320.0,"sizeGap":5.0,"brand":{"id":null,"nameKor":"나이키","nameEng":"Nike","originImagePath":"https://hongjungwan-brands-origin-temp.s3.ap-northeast-2.amazonaws.com/9a9cec61-4647-4cf5-968b-cc0e9a946730.jpg","thumbnailImagePath":"https://hongjungwan-brands-thumbnail-temp.s3.ap-northeast-2.amazonaws.com/9a9cec61-4647-4cf5-968b-cc0e9a946730.jpg"},"originImagePath":"https://hongjungwan-brands-origin-temp.s3.ap-northeast-2.amazonaws.com/9a9cec61-4647-4cf5-968b-cc0e9a946730.jpg","thumbnailImagePath":null,"resizedImagePath":null}
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=productImage; filename=productImage
Content-Type: image/png

sample
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--

Example response

HTTP/1.1 201 Created

3. 상품 정보 수정

request-fields

Path Type Description

Path	Type	Description
`nameKor`	`String`	수정할 상품의 한글명
`nameEng`	`String`	수정할 상품의 영문명
`modelNumber`	`String`	수정할 상품의 모델 넘버
`color`	`String`	수정할 상품의 색상
`releaseDate`	`String`	수정할 상품의 발매일
`releasePrice`	`Number`	수정할 상품의 발매가
`currency`	`String`	수정할 상품의 발매 통화
`sizeClassification`	`String`	수정할 상품의 사이즈 분류
`sizeUnit`	`String`	수정할 상품의 사이즈 단위
`minSize`	`Number`	수정할 상품의 최소 사이즈
`maxSize`	`Number`	수정할 상품의 최대 사이즈
`sizeGap`	`Number`	수정할 상품의 사이즈 간격
`brand`	`Object`	수정할 상품의 브랜드
`originImagePath`	`String`	기존 상품 원본 이미지 경로(null이라면 기존 이미지 삭제)

nameKor

String

수정할 상품의 한글명

nameEng

String

수정할 상품의 영문명

modelNumber

String

수정할 상품의 모델 넘버

color

String

수정할 상품의 색상

releaseDate

String

수정할 상품의 발매일

releasePrice

Number

수정할 상품의 발매가

currency

String

수정할 상품의 발매 통화

sizeClassification

String

수정할 상품의 사이즈 분류

sizeUnit

String

수정할 상품의 사이즈 단위

minSize

Number

수정할 상품의 최소 사이즈

maxSize

Number

수정할 상품의 최대 사이즈

sizeGap

Number

수정할 상품의 사이즈 간격

brand

Object

수정할 상품의 브랜드

originImagePath

String

기존 상품 원본 이미지 경로(null이라면 기존 이미지 삭제)

Example request

PATCH /products/1 HTTP/1.1
Content-Type: multipart/form-data;charset=utf-8; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Accept: application/json
Host: localhost:8080

Example response

HTTP/1.1 200 OK

4. 상품 삭제

path-parameters

Table 8. /products/{id}
Parameter	Description
`id`	삭제할 상품의 ID

Example request

DELETE /products/1 HTTP/1.1
Host: localhost:8080

Example response

HTTP/1.1 200 OK

ADMIN API

회원 전체 조회

response-fields

Path Type Description

Path	Type	Description
`content.[].id`	`Number`	ID
`content.[].email`	`String`	email
`content.[].userLevel`	`String`	userLevel

content.[].id

Number

content.[].email

String

content.[].userLevel

String

userLevel

example request

GET /admin/users HTTP/1.1
Accept: application/json
Host: localhost:8080

example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 431

{"content":[{"id":0,"email":"hong43ok@gmail.com0","userLevel":"AUTH"},{"id":1,"email":"hong43ok@gmail.com1","userLevel":"AUTH"}],"pageable":{"sort":{"sorted":false,"unsorted":true,"empty":true},"offset":0,"pageSize":10,"pageNumber":0,"paged":true,"unpaged":false},"totalPages":1,"totalElements":2,"last":true,"size":10,"number":0,"sort":{"sorted":false,"unsorted":true,"empty":true},"numberOfElements":2,"first":true,"empty":false}

회원 조회(IDX)

request-parameters

Parameter	Description
`id`	검색할 회원의 ID[PK]

response-fields

Path Type Description

Path	Type	Description
`content.[].id`	`Number`	ID
`content.[].email`	`String`	email
`content.[].userLevel`	`String`	userLevel

content.[].id

Number

content.[].email

String

content.[].userLevel

String

userLevel

example request

GET /admin/users?id=1 HTTP/1.1
Accept: application/json
Host: localhost:8080

example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 431

{"content":[{"id":0,"email":"hong43ok@gmail.com0","userLevel":"AUTH"},{"id":1,"email":"hong43ok@gmail.com1","userLevel":"AUTH"}],"pageable":{"sort":{"sorted":false,"unsorted":true,"empty":true},"offset":0,"pageSize":10,"pageNumber":0,"paged":true,"unpaged":false},"totalPages":1,"totalElements":2,"last":true,"size":10,"number":0,"sort":{"sorted":false,"unsorted":true,"empty":true},"numberOfElements":2,"first":true,"empty":false}

회원 정지

example request

POST /admin/users/ban HTTP/1.1
Content-Type: application/json
Content-Length: 27
Host: localhost:8080

{"id":1,"userStatus":"BAN"}

example response

HTTP/1.1 200 OK

CART API

장바구니 조회

response-fields

Path Type Description

Path	Type	Description
`[].id`	`Number`	CartProduct ID
`[].productId`	`Number`	상품의 ID[PK]
`[].nameKor`	`String`	상품 이름(한글)
`[].nameEng`	`String`	상품 이름(영어
`[].brand.createdDate`	`Varies`	브랜드 생성 날짜
`[].brand.modifiedDate`	`Varies`	브랜드 정보 수정 날짜
`[].brand.id`	`Number`	브랜드 ID[PK]
`[].brand.nameKor`	`String`	브랜드 이름(한글)
`[].brand.nameEng`	`String`	브랜드 이름(영어)
`[].brand.originImagePath`	`String`	브랜드 이미지 경로
`[].brand.thumbnailImagePath`	`String`	브랜드 이미지 경로(썸네일)

[].id

Number

CartProduct ID

[].productId

Number

상품의 ID[PK]

[].nameKor

String

상품 이름(한글)

[].nameEng

String

상품 이름(영어

[].brand.createdDate

Varies

브랜드 생성 날짜

[].brand.modifiedDate

Varies

브랜드 정보 수정 날짜

[].brand.id

Number

브랜드 ID[PK]

[].brand.nameKor

String

브랜드 이름(한글)

[].brand.nameEng

String

브랜드 이름(영어)

[].brand.originImagePath

String

브랜드 이미지 경로

[].brand.thumbnailImagePath

String

브랜드 이미지 경로(썸네일)

Example request

GET /carts HTTP/1.1
Host: localhost:8080

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 210

[{"id":1,"productId":2,"nameKor":"조던","nameEng":"Jordan","brand":{"createdDate":null,"modifiedDate":null,"id":3,"nameKor":"나이키","nameEng":"nike","originImagePath":"1234","thumbnailImagePath":"5678"}}]

장바구니 추가

request-fields

Path Type Description

Path	Type	Description
`id`	`Number`	상품(Product)의 ID[PK]

id

Number

상품(Product)의 ID[PK]

Example request

POST /carts HTTP/1.1
Content-Type: application/json
Content-Length: 8
Host: localhost:8080

{"id":1}

Example response

HTTP/1.1 200 OK

장바구니 삭제

request-fields

Path Type Description

Path	Type	Description
`id`	`Number`	카트상품(CartProduct)의 ID[PK]

id

Number

카트상품(CartProduct)의 ID[PK]

Example request

DELETE /carts HTTP/1.1
Content-Type: application/json
Content-Length: 8
Host: localhost:8080

{"id":1}

Example response

HTTP/1.1 200 OK

TRADE API

판매 또는 구매 입찰 시 - 필요한 정보 조회

path-parameters

Table 9. /trades/{productId}
Parameter	Description
`productId`	물품 ID[PK]

request-parameters

Parameter Description

Parameter	Description
`size`	신발 사이즈

size

신발 사이즈

example request

GET /trades/1?size=260.0 HTTP/1.1
Accept: application/json
Host: localhost:8080

Example response

HTTP/1.1 200 OK

HTTP/1.1 200 OK