건물

건물 검색 (도면 포함)

get

도면이 등록된 건물 목록을 검색합니다.

사용처

• 키워드 기반 건물 검색

• 지도 영역(bounding box) 기반 건물 조회

• 면적, 침실/욕실 수 필터링

페이지네이션

• offset 기반 페이징 (0부터 시작)

• limit: 페이지 크기 (최소 1, 최대 200)

• 응답의 hasNext로 다음 페이지 존재 여부 확인

필터 조건

• keyword: 주소명 / 도로명 / 건물명 / 사용자 설정 건물 별칭 검색

• bottomRightLat, bottomRightLon, topLeftLat, topLeftLon: 지도 영역 필터 (4개 모두 입력하거나 모두 생략)

• minArea, maxArea: 도면 면적 범위 필터 (㎡)

• bedrooms: 침실 수 필터

• bathrooms: 욕실 수 필터

• sort: 정렬 기준 (ID_DESC, ID_ASC, UPDATED_ASC, UPDATED_DESC 등)

Authorizations

x-api-keystringRequired

Query parameters

offsetinteger · int32Required

페이지 번호 (0부터 시작, offset 페이징)

limitinteger · int32Required

페이지 크기 (최소: 1, 최대: 200)

sortTypestring · enumOptional

정렬 타입

Default: ID_DESCPossible values:

keywordstringOptional

검색어 (주소명 / 도로명 / 건물명 / 건물 별칭)

bottomRightLatnumber · doubleOptional

우하단 위도 (bounding box)

bottomRightLonnumber · doubleOptional

우하단 경도 (bounding box)

topLeftLatnumber · doubleOptional

좌상단 위도 (bounding box)

topLeftLonnumber · doubleOptional

좌상단 경도 (bounding box)

minAreanumber · doubleOptional

최소 면적 (㎡)

maxAreanumber · doubleOptional

최대 면적 (㎡)

bedroomsinteger · int32Optional

침실 수

bathroomsinteger · int32Optional

욕실 수

Responses

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

application/json

resultstring · enumRequired

응답 결과 타입

Possible values:

get/api/v1/building

GET /api/v1/building?offset=1&limit=1 HTTP/1.1
Host: openapi.archisketch.com
x-api-key: YOUR_API_KEY
Accept: */*

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

{
  "result": "SUCCESS",
  "data": {
    "content": [
      {
        "id": "text",
        "enterpriseId": "text",
        "userId": "text",
        "access": "text",
        "lat": 1,
        "lng": 1,
        "floorplanDetails": [
          {
            "id": "text",
            "mapFloorplanId": "text",
            "preview": "text",
            "status": "CREATED",
            "areaInfo": {
              "areaType": "text",
              "area": "text",
              "supplyArea": 1,
              "exclusiveArea": 1
            },
            "assign": {
              "userId": "text",
              "email": "text"
            },
            "mapFloorplanRoomDetail": {
              "area": 1,
              "roomCounts": {
                "bedrooms": 1,
                "bathrooms": 1
              }
            },
            "createdAt": "2026-01-01T00:00:00.000Z",
            "updatedAt": "2026-01-01T00:00:00.000Z"
          }
        ],
        "address": {
          "numberAddress": "text",
          "roadAddress": "text",
          "buildingCode": "text",
          "buildingName": "text",
          "buildingAliases": [
            "text"
          ]
        },
        "createdAt": "2026-01-01T00:00:00.000Z",
        "updatedAt": "2026-01-01T00:00:00.000Z"
      }
    ],
    "hasNext": true,
    "totalCount": 1
  },
  "error": {
    "errorCode": "INTERNAL_ERROR",
    "message": "text"
  }
}