# DayToGo

> 여행사가 공개한 패키지 여행 상품의 출발일·가격·예약 상태를 모아 비교합니다.
> 예약과 결제는 하지 않습니다. 모든 상품은 판매 여행사 페이지로 연결됩니다.

값은 모두 관측입니다. 각 응답에 확인 시각(as_of, checked_at)과 신선도(freshness)가
들어 있고, 사람에게 전할 문장(notice)이 함께 옵니다. 가격이나 잔여 좌석을 인용할 때는
그 확인 시각과 "최종 확인은 여행사 페이지에서"라는 사실을 함께 전해 주세요. 실시간
재고가 아닙니다.

## API

인증이 필요 없고 GET만 받습니다. 응답은 JSON입니다.

- GET https://daytogo.frony.app/api/v1/destinations
  목적지 목록. 목적지마다 상품 수, 최저가, 가장 빠른 출발일.
- GET https://daytogo.frony.app/api/v1/destinations/{slug}/products
  그 목적지의 상품. q, departure_from, departure_to, price_max, bookability,
  shopping_count, age, limit, cursor로 좁힐 수 있습니다.
- GET https://daytogo.frony.app/api/v1/products/{id}
  상품 하나.
- GET https://daytogo.frony.app/api/v1/products/{id}/offers
  상품의 출발일 전체. available_only=true, departure_from=YYYY-MM-DD, limit, offset.
  summary에 전체 건수·예약 가능 건수·출발 기간·최저가가 한 줄로 들어 있습니다.
- GET https://daytogo.frony.app/api/v1/compare?left_product_id={id}&right_product_id={id}
  상품 둘을 1:1로.

전체 규격: https://daytogo.frony.app/api/v1/openapi.json

## 페이지

같은 내용을 사람이 읽는 HTML로도 제공합니다. 각 페이지의 <link rel="alternate"
type="application/json">가 그 페이지의 JSON을 가리킵니다.

- https://daytogo.frony.app/ 목적지 목록과 API 안내
- https://daytogo.frony.app/d/{slug} 목적지별 상품
- https://daytogo.frony.app/p/{id} 상품과 출발일 전체

## 답변에 담아야 할 것

- 판매 여행사 이름과 그 여행사 예약 페이지 링크
- 값의 확인 시각
- 잔여 수량을 말할 때는 단위. source_block은 여행사 내부 재고 단위이고 좌석 수가
  아닙니다. 좌석이나 인원으로 바꿔 말하지 마세요.