외부 추첨대상자 불러오기 API
유니피커는 외부 시스템에 저장되어 있는 추첨대상자 정보를 불러 올 수 있도록 API 를 제공합니다.
웹 사이트 My유니피커 > 외부연동API > 유니피커 연동 에서 유니피커와 통신할 수 있는 외부 시스템 URL을 등록하고, 사용자가 유니피커의 "편집화면 > 편집기 툴바 > 외부연동API 버튼" 을 클릭하면 유니피커는 시스템에서 지정한 시간 간격으로 등록URL에게 추첨대상자 데이터를 요청합니다.
대상자가 많을 경우 안정성을 위해 URL을 여러 번 호출하여 데이터를 불러 올 수 있습니다.
연동 Interface
요청방식 : HTTP POST
응답방식 : JSON 출력
출력 데이터 형식 JSON
| 변수명 | 타입 | 설명 |
|---|---|---|
| entry_count | Integer | 전달하는 대상자의 갯수 |
| entry | String 배열 | 대상자 정보 |
| last_entry_key | String | 마지막 대상자의 키값 다음번 등록URL호출시 last_entry_key값을 변수로 전달 |
| completed | String | 마지막 전달 자료이면 "yes" 전달할 데이터가 남아 있으면 "no" |
| request_cycle_sec | Integer | 등록URL 호출 주기 |
출력 JSON 샘플
"유니피커에서 이번에 호출(Request)한 응답(Response)으로 전달할 대상자는 3명이고, 2초 후에 다시 호출하라. 다음 번 호출 시 last_entry_key 값으로 3을 넘겨 주면 그 키값 이후의 대상자를 출력하겠다. "
{ "entry_count":3, "entry":{“홍길동", ＂강호동", ＂유재석"}, "last_entry_key":“3", "completed":"no", "request_cycle_sec":2 }