/jwp_cat_picture_search

Primary LanguageJava

jwp_cat_picture_search

주의사항

주제(시나리오)

고양이를 좋아하는 당신은 고양이 사진 전용 검색 웹사이트를 구현해보려고 합니다. 고양이 사진이 나와야 하기 때문에 데이터를 가져와야 하는데 좋은 오픈 API가 존재합니다. 그 API를 이용해 데이터를 DB에 저장하고 서비스를 만들어 봅시다.

과제 설명

  • thecatapi에서 일부분의 데이터를 가져옵니다.
  • 매번 API를 쏘는건 비효율적이니 간단하게 데이터를 DB에 저장해봅니다.
  • DB를 세팅하기 위해 Docker를 이용해서 DB세팅을 해봅니다.
  • 그 데이터를 가지고 필요한 API를 만들어 봅니다.

API

1. GET /cats/random50

Request parameter

None

Query paramter

None

Response

Success 200

Field name Type Description
data Array 랜덤한 50개의 고양이 사진 목록입니다. 
HTTP/1.1 200 OK
{
  "data": [{
    id: string
    url: string
    name: string
  }]
}

2. GET /cats/search

Request parameter

None

Query paramter

Field name Type Description
q string 고양이의 품종(영어/한글)

Response

Success 200

Field name Type Description
data Array Keyword로 검색된 고양이 사진 목록입니다. 
HTTP/1.1 200 OK
{
  "data": [{
    id: string
    url: string
    name: string
  }]
}

3. GET /cats/:id

Request parameter

Field name Type Description
id string 고양이 사진의 id값 입니다.

Query paramter

None

Response

Success 200

Field name Type Description
data Object Id로 검색된 고양이 사진 입니다. 
HTTP/1.1 200 OK
{
  "data": {
    name: string
    id: string
    url: string
    width: number
    height: number
    temperament: string
    origin: string
  }
}
``