안녕하세요, 오픈서베이 팀입니다.
항상 오픈서베이를 이용해 주시는 고객 여러분께 진심으로 감사드립니다.
더 안정적이고 일관된 API 환경을 제공하기 위해 2026년 12월부로 V1 및 V2 API의 공식 지원을 종료합니다.
이에 따라 현재 V1 또는 V2 API를 사용 중이신 경우, 반드시 종료일 이전까지 V3 API로 전환을 완료해 주시기를 바랍니다.
자세한 내용은 아래를 참고해 주세요.
상세 내용
■ API 지원 종료 예정
2026년 12월
■ API 지원 종료 관련 자주 묻는 질문 (FAQ)
Q. 과거 버전은 계속 사용할 수 있나요?
A. 현재는 V1·V2 API와 V3 API가 병행 제공되고 있지만, 2026년 12월 이후에는 과거 버전 API의 공식 지원이 종료됩니다. 종료 전까지 V3 API로의 전환을 권장해 드립니다.
지원 종료일 이후에는 V1·V2 API 호출이 불가능하며, 해당 API를 활용한 자동화 시스템이나 외부 연동 작업에도 영향이 있을 수 있습니다.
기술 담당자 또는 개발팀과 협의하여, 사전 전환 작업을 여유 있게 준비해 주시기를 권장해 드립니다.
Q. 기존 API 호출 코드를 어떻게 바꿔야 하나요?
A. 각 API 버전 간 일부 응답 필드 및 호출 방식에 차이가 있으므로, V3 API 스펙 문서를 참고해 코드 수정을 진행해 주세요.
제거된 API: 응답 URL 조회, 수집그룹 serial 조회
대체 방법: 통합 API 구조 및 응답자 UID 기반 HMAC 서명 방식 적용
Q. V3에서는 문항의 rank 정보가 없어졌는데, 문항 순서는 어떻게 확인하나요?
A. V3 API는 rank(문항 순서) 값을 제공하지 않으며, 대신 고유한 name 필드(Q1, Q2 등)를 통해 문항을 구분합니다. 문항 리스트의 순서를 기준으로 순서를 확인하실 수 있습니다.
Q. 응답 URL 조회 API는 왜 사라졌나요?
A. 개별 응답 URL을 조회하는 별도 API는 제거되었으며, 수집 그룹 정보 API 내 응답 URL 포함 방식으로 통합되었습니다. 또한, HMAC 서명 방식을 통해 응답자 UID를 생성해 링크를 구성하실 수 있습니다.
Q. 수집그룹 serial 조회 API는 왜 제거되었나요?
A. 기존 serial 조회 API는 도메인 변경 등 시스템 변경 시 유지보수에 어려움이 있어, 도메인이 포함된 응답 링크를 수집 그룹 정보 API를 통해 제공하는 방식으로 개선하였습니다.
📌 꼭 확인해 주세요
기술 담당자가 아닐 경우, 해당 내용을 IT팀 또는 개발자에게 전달해 주세요.
자동화 시스템이나 외부 연동 기능에 영향을 줄 수 있으므로, 관련 부서에 꼭 전달해 주세요.V3 API 문서를 참고해 사전 코드 전환을 준비해 주세요.
서비스 이용에 차질이 없도록 이전 가이드를 미리 확인해 주시기 바랍니다.
오픈서베이는 앞으로도 고객 여러분께 신뢰할 수 있는 환경을 제공하기 위해 기술 기반 고도화에 최선을 다하겠습니다.
추가 문의 사항은 화면 우측 하단 문의 아이콘을 통해 언제든지 문의해 주세요.
감사합니다.
오픈서베이 드림