플랫폼 연동

Studio가 PlantPulse 플랫폼의 설비 데이터를 읽어오는 통로입니다. 앱이 어떤 태그를 쓸지 고를 때, 그리고 연동이 살아 있는지 확인할 때 씁니다.

연동 상태

GET /api/platform/health

플랫폼에 닿는지, 인증이 유효한지 확인합니다. 앱이 데이터를 못 읽을 때 가장 먼저 볼 곳입니다.

데이터 탐색

GET /api/platform/browse?path={path}

사이트 → 라인 → 설비 → 태그 순으로 계층을 내려가며 탐색합니다. path 는 URL 인코딩합니다. 빈 값이면 최상위입니다.

시맨틱 계층

플랫폼은 설비 구조를 온톨로지로 들고 있습니다. 태그 이름이 현장마다 달라도 의미로 찾을 수 있게 하는 계층입니다.

메서드	경로	하는 일
GET	/api/semantic/ontology	전체 온톨로지
GET	/api/semantic/ontology?site={siteId}	한 사이트의 트리
GET	/api/semantic/search?q={질의}	의미 기반 검색

검색은 다음 옵션을 받습니다.

옵션	뜻
site	특정 사이트로 한정
type	결과 종류로 한정 (설비, 태그 등)
limit	결과 개수

태그 이름을 정확히 모를 때 — "3라인 압축기 토출 온도" 같은 말로 — 찾는 용도입니다.