Departure place

출발지 통합 검색

인증:

  • Access Token: 선택 — 회원 검색 시 사용
  • inviteCode: 조건부 필수 — Access Token이 없는 게스트에게 필수
  • 둘 다 전달: Access Token 우선, inviteCode 무시
  • 잘못된 Access Token: 401, inviteCode 방식으로 fallback하지 않음

통합 이유:

  • 회원과 게스트의 검색 요청·응답 및 카카오 검색 로직이 동일함
  • 인증 수단만 서버에서 분기해 하나의 API로 제공함

검색:

  • 정확히 ~역: 지하철역 우선 검색 후 결과가 없으면 일반 장소 검색
  • 도로명·지번 주소형(번지 포함): 주소 우선 검색 후 결과가 없으면 일반 장소 검색
  • 단독 지명·지하 주소 및 그 외: 일반 장소 검색
  • 결과 좌표: WGS84 위도·경도 포함
post/api/departure-places/searches

Request

  • Base URL: https://3-35-119-70.sslip.io
  • URL: https://3-35-119-70.sslip.io/api/departure-places/searches
  • Auth: one of:
    • HTTP bearer
    • none

Query parameters

inviteCodestring

회원: 선택(전달해도 무시) / 게스트: 필수인 모임 초대코드

Request body

keywordstring required

역명, 도로명·지번 주소 또는 일반 장소명

Example request

{
  "keyword": "서울역"
}

Response

출발지 통합 검색 성공

Changes

No recorded changes to this operation across all 1 revision of this API.