가이드

REST API 호출

GET 경로 두 개와 하나의 응답 형태. 어떤 HTTP 클라이언트든 되고, 어떤 브라우저 출처에서도 호출할 수 있습니다.

기본 URL

https://api.waity.ai

장소 찾기

GET /v1/places

다음 중 하나를 보내세요: 위치(near=lat,lng 또는 X-Waity-Location 헤더), q(장소 이름, 도시, 공항 코드, ZIP 또는 “브루클린 근처 응급실” 같은 평이한 질문), 또는 ids. 선택: category, open, sort, limit, view.

curl "https://api.waity.ai/v1/places?q=El+Paso&category=border&view=minimal"

한 장소

GET /v1/places/{id}

선택: under(분), travel_min(next.leave_by 추가), date(최대 7일 후), forecast, view. 공항, 국경 검문소 또는 병원 캠퍼스 ID는 그 안의 레인이나 부서를 반환합니다.

curl "https://api.waity.ai/v1/places/pl_xaed7pr1f5?travel_min=15&view=minimal"

인증

키 없이도 호출할 수 있습니다. 키가 있으면 X-Api-Key 또는 Authorization: Bearer로 보내세요.

curl "https://api.waity.ai/v1/places/pl_xaed7pr1f5?view=minimal" \
  -H "X-Api-Key: $WAITY_API_KEY"

보기

view=minimal은 핵심만 반환하며 전체 보기의 엄격한 부분집합입니다: 같은 키, 같은 경로, 더 적은 항목. MCP 도구의 기본값입니다.

레퍼런스

모든 경로, 파라미터, 응답은 API 레퍼런스에 있으며, 스키마는 openapi.json입니다.