경매

경매 리스트 확인

Context-type : application/json

메소드	경로	짧은 설명
GET	/auction/auctionList	경매 상품 리스트 조회

Response

Success

{
    "code": 200,
    "json": {
        "success": true,
        "message": "경매 상품 전체 조회 성공",
        "data": [
            {
    "code": 200,
    "json": {
        "success": true,
        "message": "경매 상품 전체 조회 성공",
        "data": [
            {
                "mainImg": "https://fluff-s3.s3.ap-northeast-2.amazonaws.com/1577986094350.jpg",
                "auctionName": "Gucci 플로얼 자카드 코트",
                "bid": 10000,
                "_id": "5e0e282f3c493169d01b9bff",
                "size": "sm",
                "condition": 10,
                "comment": "Gucci(구찌) 클래식 셀렉션의 플로럴 자카드 코트. 스프레드 칼라, 플로럴 패턴, 자카드 효과, 메탈릭 광택, 긴소매, 플랩 포켓. 파페치 클래식 셀렉션에서 시간이 지날수록 가치를 더하는 아이코닉한 디자인을 만나보세요. 파페치 파트너 스토어가 엄선하여 수집한 상품(pre-owned)으로 사용된 적이 없지만, 세월의 흔적으로 인한 가벼운 손상이 있을 수 있습니다"
            },
            {
                "mainImg": "https://fluff-s3.s3.ap-northeast-2.amazonaws.com/1577986294679.jpg",
                "auctionName": "OKHTEIN 나즐리 토트 백",
                "bid": 10000,
                "_id": "5e0e28f73c493169d01b9c00",
                "size": "sm",
                "condition": 10,
                "comment": "다각형의 유니크한 쉐입으로 들고만 있어도 포인트를 줄 수 있는 토드백으로, 가죽 100%를 사용하여 고급스러움을 더했습니다."
            },
            {
                "mainImg": "https://fluff-s3.s3.ap-northeast-2.amazonaws.com/1577986508288.jpg",
                "auctionName": "프라다 반소매 플레어 드레스",
                "bid": 10000,
                "_id": "5e0e29cc3c493169d01b9c01",
                "size": "sm",
                "condition": 10,
                "comment": "Prada Vintage의 반소매 플레어 드레스. 레드 색상, 깊게 파인 V-넥, 짧은 길이. 빈티지 상품은 세월의 흔적으로 인한 가벼운 손상이 있을 수 있습니다. 2000년도 상품입니다."
            },
            {
                "mainImg": "https://fluff-s3.s3.ap-northeast-2.amazonaws.com/1577985548226.jpg",
                "auctionName": "ETRO 프린트 믹스 드레스",
                "bid": 600000,
                "_id": "5e0e260d3c493169d01b9bfb",
                "size": "md",
                "condition": 10,
                "comment": "다각형의 유니크한 쉐입으로 들고만 있어도 포인트를 줄 수 있는 토드백으로, 가죽 100%를 사용하여 고급스러움을 더했습니다."
            }
        ]
    }
}
        ]
    }
}

Fail : 존재하지 않는 경매 상품

{
    "code": 403,
    "json": {
        "success": false,
        "message": "경매 상품 리스트가 존재하지 않습니다.",
    }
}

Fail : 서버 내부 에러

{
    "code": 500,
    "json": {
        "success": false,
        "message": "경매 상품 리스트 조회 실패",
    }
}

---

경매 입찰하기

Context-type : application/json

메소드	경로	짧은 설명
POST	/auction/:id/bid	경매 입찰

Request

query string

auctionId={입장할 경매방}

socketIO

/socket

body

{
    "bid": 20000
}

Response

Success : socket 답장하기

{
    "bid": 20000
}

Fail : 경매 상품 요청 파라미터가 잘못됨.

{
    "code": 400,
    "json": {
        "success": false,
        "message": "파라미터 값이 잘못 되었습니다."
    }
}

Fail : 서버 내부 에러

{
    "code": 204,
    "json": {
        "success": false,
        "message": "요청에 일치하는 경매 상품이 없습니다.",
    }
}

Fail : 경매가 종료됨.

{
    "code": 403,
    "json": {
        "success": false,
        "message": "경매가 이미 종료 되었습니다.",
    }
}

Fail : 입찰 정보가 유효하지 않음.

{
    "code": 403,
    "json": {
        "success": false,
        "message": "입찰 정보가 유효하지 않습니다.",
    }
}

Fail : 시작 가격보다 낮은 가격입찰.

{
    "code": 403,
    "json": {
        "success": false,
        "message": "시작 가격보다 높게 입찰해야 합니다.",
    }
}

Fail : 시작 가격보다 낮은 가격입찰.

{
    "code": 403,
    "json": {
        "success": false,
        "message": "이전 입찰가보다 높아야 합니다.",
    }
}

Fail : 시작 가격보다 낮은 가격입찰.

{
    "code": 500,
    "json": {
        "success": false,
        "message": "입찰 서버 내부 오류",
    }
}

---

경매 상품 등록

Context-type : application/json

메소드	경로	짧은 설명
POST	/auction/register	경매 상품 등록

Request

body

{
    "auctionNmae": "경매 상품 이름",
    "mainImg": "메인 이미지",
    "img": ["이미지", "리스트"],
    "color": "상품 색상",
    "category": "상품 카테고리",
    "hashtag": "상품 해시태그",
    "size": "사이즈",
    "startCost": "시작 가격",
    "comment": "판매자 한줄 평",
    "condition": "상품 상태",
    "style": ["스타일", "리스트"],
    "period": 원하는 시간
}

Response

Success

{ color: [ 'red' ],
  style: [ 'lovely', 'unique' ],
  img:
   [ 'https://fluff-s3.s3.ap-northeast-2.amazonaws.com/1578060830465.jpg',
     'https://fluff-s3.s3.ap-northeast-2.amazonaws.com/1578060830471.jpg',
     'https://fluff-s3.s3.ap-northeast-2.amazonaws.com/1578060830500.jpg',
     'https://fluff-s3.s3.ap-northeast-2.amazonaws.com/1578060830504.jpg' ],
  saleAuth: true,
  _id: 5e0f4c1f0eed0b05e0420f47,
  auctionName: 'SUjjj',
  sellerName: '5e0a416f217f2200119b6037',
  size: 'sm',
  startCost: 30000,
  comment: 'test',
  condition: 10,
  sellerId: 5e0a416f217f2200119b6037,
  restTime: 1970-01-01T00:00:00.007Z,
  authorize: true,
  period: 10,
  bid: [],
  createdAt: 2020-01-03T14:13:51.215Z }

Fail : 경매 등록 실패

{
    "code": 400,
    "json": {
        "success": false,
        "message": "경매 등록 실패",
    }
}

---

경매 상품 인가

Context-type : application/json

메소드	경로	짧은 설명
POST	auction/auth	경매 상품 인가

Request

body

{
    "auth": true,
}

Response

Success : 경매 상품 인가 승인

{
    "code": 200,
    "json": {
        "success": true,
        "message": "경매 상품을 인가하였습니다.",
        "data": {
            "auctionNmae": "경매 상품 이름",
            "mainImg": "메인 이미지",
            "img": ["이미지", "리스트"],
            "color": "핑크",
            "category": "아우터",
            "hashtag": ["해시태그", "해시태그"],
            "size": "xxlg",
            "startCost": 20000, 
            "comment": "플러프와 함께라면", 
            "condition": 10, 
            "style": ["스타일", "리스트"],
            "highestCost": 0,
            "mainImg": "imgURi",
            "img": ["imageUri", "imageUri"],
            "saleAuth": true,
            "bid": [],
            "createdAt": "2019-12-26T11:18:43.878+00:00",
        }
    }
}