API

API는 서로 다른 소프트웨어가 정해진 규칙에 따라 데이터를 주고받는 연결 창구다. 사이니지에서는 CMS가 외부 시스템의 데이터를 가져오거나, 외부 시스템이 CMS를 조작할 때 쓴다.

사이니지에서의 쓰임

• 외부 데이터를 화면에 표시: 날씨, 환율, 대기 번호, 교통 정보, 재고와 가격
• 다른 시스템과 연결: POS 연동, 예약 시스템, 회의실 예약, 사내 공지 시스템
• 외부에서 CMS 제어: 다른 프로그램이 콘텐츠를 등록하거나 편성을 바꾼다.
• 장치 상태 수집: 원격 모니터링 정보를 자체 관제 시스템으로 가져온다.

연결 방향

• CMS가 주기적으로 외부 시스템에 물어보는 방식. 반영까지 조회 주기만큼 지연이 생긴다.
• 외부 시스템에서 변화가 생겼을 때 CMS에 알려주는 방식. 반영이 빠르지만 양쪽 모두 지원해야 한다.

도입 전에 확인할 것

• 연동하려는 시스템이 API를 제공하는지, 유료인지
• 필요한 데이터가 API로 실제 제공되는지. API가 있어도 원하는 항목이 빠져 있는 경우가 많다.
• 호출 횟수 제한
• 인증 방식과 인증 정보의 보관 위치
• API가 바뀌거나 중단될 때의 통지 방식

장애 대비

외부 시스템은 언제든 응답하지 않을 수 있다. 데이터를 받지 못했을 때 화면에 무엇을 보여줄지 미리 정해 둔다. 마지막으로 받은 값을 유지할지, 해당 영역을 숨길지, 기본 콘텐츠로 바꿀지를 정하지 않으면 빈 화면이나 오류 문구가 그대로 노출된다.

더 알아보기

• API 연동 실패와 재시도: 시간 초과와 통신 실패 뒤 중복 처리, 정보 역전, 요청 집중을 방지하며 복구하는 방법.
• 외부 센서와 화면 이벤트: 센서·버튼·외부 시스템의 이벤트를 화면 전환으로 연결할 때 중복·우선순위·복귀를 관리하는 방법.