공개 API v1
웹사이트와 같은 단지 데이터를 REST로 받아요. 인증 없이 읽기 전용이고, 스펙은 OpenAPI 3.1이에요.
RESTOpenAPI 3.1
첫 요청#
터미널
curl "https://reevl.co.kr/api/v1/apartments?sido=서울&gu=강남구&hh_min=1000&limit=20"엔드포인트#
| 경로 | 하는 일 |
|---|---|
| GET /api/v1/meta | 유효값과 수치 축의 범위 - 다른 호출 전에 먼저 |
| GET /api/v1/apartments | 조건으로 단지 조회(JSON 최대 100건 · CSV 최대 5,000행) |
| GET /api/v1/apartments/{cid} | 단지 하나의 전체 축 |
자주 쓰는 파라미터#
전체 목록은 openapi.json에 있어요.
| 이름 | 뜻 |
|---|---|
| <축>_min · <축>_max | 수치 축의 범위(포함) |
| q | 단지명 부분일치 |
| sort · order | 정렬 축과 방향(asc · desc) |
| fields | 응답 축 - 'all' 또는 쉼표 구분 |
| format | json(기본) 또는 csv |
| limit · offset | 개수와 건너뛸 수 |
주의#
분당 60회까지예요. 문자 축은 완전일치라 /api/v1/meta로 값을 먼저 확인하세요.