Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

CIMON REST API란..

SCADA PRO Web서버에서는 CIMON Historian Database에 저장된 데이터를 누구나 손쉽게 요청할 수 있도록REST API를 통해 데이터를 제공합니다. 인증 절차를 통해 확인된 사용자에게 아래 데이터 4가지 데이터를 REST API 방식으로 공유하여 이를 최종 고객 측에서 활용할 수 있도록 지원합니다.

...

1. 페이지 레코더

...

API

UltimateAccess Web server provides REST API that lets anyone easily request the data in CIMON Historian Database. The verified end user may utilize the 4 types of data shared via REST API.

1. Page Recorder

Get recorded data list

URL : http://(IP):(PORT)/pageRec/page_rec_time

...

Request

Response

Code Block
{
  "pageName":"페이지이름Pagename"
}

Code Block
{
  "data": [
    { 
      "start_time": (시작Start 시간time), 
      "end_time": (종료End 시간time), 
      "min_sec": (Minute/Second)
    },
    …
  ]
}

2. 데이터 수집

...

Data Log

Get data log

URL : http://(IP):(PORT)/dataLog/get_log_rawdata

...

Request

Response

Code Block
{
  "tagArr": 
    [
      "TAG1", 
      "TAG2", 
      "TAG3"
    ],
  "startTime":"yyyy/MM/dd hh:mm:ss", 
  "endTime":"yyyy/MM/dd hh:mm:ss"
}

Code Block
{
  "data":[
    { 
      "time": (시간Time), 
      "tag_name": (태그Tag 이름name), 
      "tag_value": (태그Tag value)
    },
    …
  ]
}

3. 과거 경보

...

Alarm History

Get alarm history

URL : http://(IP):(PORT)/historyAlarm/get_history_alarm

...

Headers : ‘Content-Type’: ‘application/json’

비고 NOTE : order 파라미터에 Enter asc (오름차순ascending) / or desc (내림차순) 입력하여 결과 요청descending) to the parameter order to request data.

Request

Response

Code Block
{
 "startTime":"yyyy/MM/dd hh:mm:ss", 
 "endTime":"yyyy/MM/dd hh:mm:ss",
 "order":"asc"
}

Code Block
{
  "data": [
    { 
      "time": (시간Time), 
      "freetime": (해제Cleared 시각time),
      "almtime": (경보Alarm 시간time),
      "occtime": (발생Occurred 시간time),
      "tag_name": (태그Tag 이름name), 
      "value": (태그Tag value),
      "statuscode": (상태Status 코드code),
      "status": (상태Status),
      "typecode": (타입Type 코드code),
      "type": (타입Type),
      "almlabel": (알람Alarm 라벨label),
      "areacode": (지역Alarm zone 코드code),
      "area": (지역Alarm zone),
      "priority": (등급Alarm level)
    },
    …
  ]
}

4. 네트워크 상태

...

Network Status

Get network status

URL : http://(IP):(PORT)/networkStatus/get_network_status

...

Request

Response

Code Block

Code Block
{
  "data": [
    { 
      "station": (통신 드라이버Station), 
      "address": (통신 주소),
      "description": (드라이버Station 설명description),
      "status": (정상Normal or/ 이상Abnormal),
      "read": (읽기Amount of 개수reads), 
      "readerr": (읽기Read 에러error),
      "readprect": (읽기Read success 성공률rate),
      "write": (쓰기Amount of 개수writes),
      "writeerr": (쓰기Write 에러error),
      "writeprect": (쓰기Write success 성공률rate)
    },
    …
  ]
}