localization 에 따라, 언어 필드를 추가함. HTTP 표준에 따라 Accept-Language 필드를 헤더에 담아 보내며, 해당 필드에 값이 없을 경우 한글로 에러메시지를 출력함. Accept-Language 필드는 이 링크의 값을 따름. 현재 사용되는 Accept-Language 값은 다음과 같음
표준에 따라 국가 코드를 함께 보내도 무관함 (ex : ko-KR, en-US)
로그인 기능이 추가됨에 따라 특정 API에서는 로그인시 획득할 수 있는 토큰을 함께 전송해주어야 합니다.
그러한 API 의 경우 Need Token 라벨을 함께 표기하도록 하겠습니다.
로그인시 획득할 수 있는 토큰의 유효기간은 30일로 유효기간이 지나거나 잘못된 토큰의 경우 39xx의 에러코드를 받게 됩니다.
이 외의 API는 기존과 같이 아래의 토큰을 함께 전송해주시면 사용 가능합니다.
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwZXJtaXNzaW9uIjp0cnVlfQ.E_jteIkFEH3Sge_QbN3L7rpZpSvBiO8oBi6f9HEWmsA
API는 항상 다음 형태를 기본으로 response 합니다
{ code : 결과 코드 (항상 0) ,msg : 결과 메시지 (대게 success) ,data : 결과 데이터 }
결과 데이터가 배열 형태인 경우 다음으로 response 합니다.
{ code : 결과 코드 (항상 0) ,msg : 결과 메시지 (대게 success) ,data : { list : [데이터1, 데이터2, ...] } }
HTTP Response는 항시 200 OK로, 에러가 있을 경우 내부에 code를 담아 전송하게 됩니다. 에러의 경우 위와는 조금 다르게 다음의 결과를 전송합니다.
{ code : 결과 코드 ,msg : 에러 메시지 ,log_id : 에러 로그의 아이디 }
code | description |
---|---|
CD000401 | 대학 |
CD000501 | 연구기관 |
CD000601 | 기업부설연구소 |