AAS REST API v3.0 — BaSyx 스타일 전체 엔드포인트 맵

Shell 관리5 endpoints

GET

/api/v3.0/shells

전체 Shell 목록

GET

/api/v3.0/shells/{aasId_b64}

단일 Shell 조회

POST

/api/v3.0/shells

Shell 생성

PUT

/api/v3.0/shells/{aasId_b64}

Shell 업데이트

DELETE

/api/v3.0/shells/{aasId_b64}

Shell 삭제

Submodel 관리4 endpoints

GET

/api/v3.0/shells/{aasId_b64}/submodels

SM 목록

GET

/api/v3.0/shells/{aasId_b64}/submodels/{smId_b64}/submodel

SM 전체 조회

POST

/api/v3.0/shells/{aasId_b64}/submodels/{smId_b64}

SM 등록

PUT

/api/v3.0/shells/{aasId_b64}/submodels/{smId_b64}/submodel

SM 교체

SubmodelElement 관리3 endpoints

GET

/api/v3.0/shells/{aasId_b64}/submodels/{smId_b64}/submodel-elements/{path}

Element 조회

PUT

/api/v3.0/..../submodel-elements/{path}/$value

값 업데이트

POST

/api/v3.0/..../submodel-elements/{path}/invoke

Operation 실행

path 표현 예시

WorkList.Work_S9.duration

점 표기법으로 중첩 element 접근

ConceptDescription2 endpoints

GET

/api/v3.0/concept-descriptions

CD 목록 조회

GET

/api/v3.0/concept-descriptions/{id_b64}

단일 CD 조회

ConceptDescription 용도

semanticId의 의미 정의 저장소.
ECLASS, IEC CDD IRI를 키로 조회.
DataSpecification(IEC61360) 포함.

DemoServer 전용 — 학습용 API6 endpoints

GET

/db/equipment

5자산 목록

GET

/db/equipment/{id}/properties

장비 속성 전체

PUT

/db/equipment/{id}/properties/{name}

속성값 변경

GET

/db/equipment/{id}/state-log

상태 이력

GET

/health

서버 상태

GET

/dashboard

대시보드 HTML

URL 경로 파라미터 — Base64Url 인코딩

aasId_b64

= Base64Url( globalAssetId )

원본: https://plant142.local/shells/LR01
인코딩: aHR0cHM6Ly9wbGFudDE0Mi5sb2NhbC9zaGVsbHMvUjE0MS0x

smId_b64

= Base64Url( Submodel.id )

원본: https://plant142.local/submodels/LR01/Nameplate
인코딩: aHR0cHM...KTmFtZXBsYXRl

path

= idShort 점 표기법

단일: assembly_force
중첩: WorkList.Work_S9.duration
컬렉션: OperationHistory[0].result

Base64Url = Base64 + URL-safe (+→- /→_ =패딩제거)

Python: base64.urlsafe_b64encode(id.encode).rstrip(b'=').decode

JS: btoa(id).replace(/\+/g,'-').replace(/\//g,'_').replace(/=/g,'')