Open API
콘티플에서 헬프센터 공지사항, FAQ, 티켓 정보 등 다양한 상담 정보를 Open API로 제공합니다.
➊ API 인증 방법
1-1. OPEN API 활성화
[서비스 관리] → [인증]에서 OPEN API를 활성화해주세요.
활성화 시, 서비스 Key가 자동 생성됩니다.
API를 호출하고 전송되는 데이터를 암호화하는 데에 사용하는 인증키입니다.
API Key 변경 버튼을 클릭하여 변경할 수 있습니다.
1-2. 인증 Header
각 Request Header에 아래의 값들을 반드시 설정해주세요.
보안 서비스 기능을 사용하는 서비스의 경우, [서비스 관리] → [보안 서비스] → [스팸 관리] 메뉴에서 고객의 IP를 통한 스팸 정책을 활성화할 수 있습니다.
Open API를 통해 티켓 생성 시, OC-Client-IP 값을 Request Header에 설정하시면 해당 IP를 기준으로 스팸 여부를 판단합니다.
Authorization : Security Key를 통해 생성된 인증 문자열
X-TC-Timestamp : 현재 UTC 시간 값 {new Date().getTime()}
OUCODE : 유저 Code (설정하지 않을 경우, 기본값 Owner)
1-3. Authorization 문자열 생성 방법
다음 2가지 방법으로 문자열을 생성할 수 있습니다.
① HmacSHA256로 암호화
② (NHN Cloud 조직 ID + Request URI + 파라미터 값 + 현재 UTC 시간 값)문자열에 대해 암호화
NHN Cloud 조직 ID 확인 방법
[전체 관리] → [계약 서비스 현황] → [조직 정보]에서 확인해주세요.
1-4. JAVA 예제
(1) 일반 요청(GET)
(2) 일반 요청(POST)
(3) 파일 업로드
(3) 콘티플 측 인증 방법
콘티플 인증 실패 시, 결과는 아래와 같이 반환됩니다. (Authorization 문자열의 암호화 방식이 올바른지 확인해주세요.)
인증 실패 상황
400
Authorization is blank
X-TC-Timestamp is not numeric
X-TC-Timestamp is expired (5분 내 유효)
Multipart request but file is null
Authorization is incorrect
403
securityKey is null
clientIp is not allowed
➋ 공통 리턴 결과
2-1. 리턴 결과 예제
2-2. 리턴 결과 설명
Header
resultCode
Integer
리턴 결과 Code, 정상은 200
resultMessage
String
리턴 오류 메시지
isSuccessful
Boolean
실행 결과(성공: true, 실패: false)
Result
contents
JSON
목록 결과 내용
content
JSON
상세 결과 내용
2-3. 리턴 코드
200 : SUCCESS
400 : Bad Request
403 : Access Denied(Forbidden)
404 : Not Data Found
500 : Server Error
9007 : 관련된 데이터가 이미 존재
9005 : 관련된 데이터가 없음
1001 : 문의 횟수가 상한을 초과했습니다. 잠시 후 문의해주세요.
[스팸 관리] → [반복 문의 차단] 기능 사용 시 작동
동일 IP로 1분 내에 3번 이상 문의 생성 시도 시, 24시간 동안 티켓 생성 차단
1002 : 문의 횟수가 상한을 초과했습니다. 잠시 후 문의해주세요.
[스팸 관리] → [반복 문의 차단] 기능 사용 시 작동
동일 IP로 24시간 내에 10번 이상 문의 생성 시도 시, 24시간 동안 티켓 생성 차단
2-4. 리턴 코드(실패) 상세
400
Authorization is blank
X-TC-Timestamp is not numeric
X-TC-Timestamp is expired (5분 내 유효)
Multipart request but file is null
Authorization is incorrect
403
securityKey is null
clientIp is not allowed
➌ API 목록
3-1. 개발 환경 URL
알파
https://{domain}.oc.alpha-nhncloud.com
베타
https://{domain}.oc.beta-nhncloud.com
리얼
https://{domain}.oc.nhncloud.com
3-2. Security Key URL
서비스의 Security Key
/{serviceId}/openapi/v1/*
인증 없이 직접 사용 가능
/{serviceId}/api/v2/*
3-3. API 목록
서비스
서비스 상세
GET
/{serviceId}/api/v2/service.json
서비스 ID를 통해 서비스 정보 조회
공지사항
말머리 리스트
GET
/{serviceId}/api/v2/notice/categories.json
공지사항 말머리 리스트 취득
태그 리스트
GET
/{serviceId}/api/v2/notice/tags.json
공지사항 태그 리스트 취득
공지사항 리스트
GET
/{serviceId}/api/v2/notice/list.json
헬프센터 공지사항 리스트
공지사항 상세
GET
/{serviceId}/api/v2/notice/detail/{id}.json
공지사항 ID를 통해 공지사항 내용 취득
공지사항 첨부파일 열기 및 다운로드
GET
/{serviceId}/api/v2/notice/attachments/{id}
공지사항 첨부파일 열기/다운로드
FAQ
카테고리 리스트
GET
/{serviceId}/api/v2/helpdoc/categories.json
FAQ 카테고리 리스트 취득
FAQ 리스트
GET
/{serviceId}/api/v2/helpdoc/list.json
헬프센터 FAQ 리스트
FAQ 상세
GET
/{serviceId}/api/v2/helpdoc/detail/{id}.json
FAQ ID를 통해 FAQ 내용 취득
FAQ 첨부파일 열기 및 다운로드
GET
/{serviceId}/api/v2/helpdoc/attachments/{id}
FAQ 첨부파일 열기 및 다운로드
문의 접수
접수유형 리스트
GET
/{serviceId}/api/v2/ticket/categories.json
서비스 내 접수유형 리스트 조회
접수유형 필드 리스트
GET
/{serviceId}/api/v2/ticket/field/user/{categoryId}.json
접수유형을 통하여 대응되는 필드 리스트 확인
티켓 첨부파일 업로드
POST
/{serviceId}/openapi/v1/ticket/attachments/upload.json
서버에 파일 업로드
티켓 생성
POST
/{serviceId}/openapi/v1/ticket.json
신규 티켓 생성
문의 내역
고객 티켓 리스트
GET
/{serviceId}/openapi/v1/ticket/enduser/{usercode}/list.json
검색 조건을 통해 조건에 맞는 고객의 티켓 리스트 노출
티켓 상세
GET
/{serviceId}/openapi/v1/ticket/enduser/{usercode}/{ticketId}/detail.json
고객이 접수한 티켓 상세 조회
티켓 첨부파일 열기 및 다운로드
GET
/{serviceId}/api/v2/ticket/attachments/{id}
티켓 첨부파일 열기/다운로드
고객 재문의
POST
/{serviceId}/openapi/v1/ticket/enduser/{usercode}/{ticketId}/comment.json
티켓 ID 기준으로 고객 재문의
Last updated