인증서(자격증) 정보 취득 Api
!주의!
Token api를 클라이언트(JavaScript)에서 호출하여 사용하지 마세요.
Token api의 목적은 안전한 경로에서 호출하여 신뢰성 있는 인증서 데이터를 취득하기 위함 입니다.
Token을 Back-end등 외부로부터 안전한 환경으로 전달한 후, Token api를 호출해 주세요.
1. 필요 정보
Token api 호출을 위해서는 아래 정보가 필요합니다.
1.
APP ID, APP Secret - 애플리케이션 생성으로 취득. 가이드 링크
2.
Token - JavaScript 패키지를 통해 취득. 가이드 링크
2. Api 호출
위 정보를 바탕으로 아래 api를 호출하여 인증서 정보를 취득할 수 있습니다.
1.
token을 path에 넣은 후
2.
APP ID, APP Secret을 바탕으로 Basic auth header를 작성하여 보내주세요.
•
URL
https://certi.programmers.co.kr/api/v1/certificate/selected-certificates/{token}
•
Method
GET
•
Path
token
•
Header
Authorization: Basic base64encode(APPID:APPSecret)
# python 기준
APPID = "APPID"
APPSecret = "APPSecret"
# QVBQSUQ6QVBQU2VjcmV0
encoded_value = base64.b64encode(f"{APPID}:{APPSecret}".encode()).decode()
Authorization = f"Basic {encoded_value}"
Python
복사
Response
{
"id": number,
"token": string,
"certificate": {
"id": number,
"level": number,
"code": string,
"language": string,
"expireAt": string,
"email": string,
"name": string,
"birthdate": string,
"classificationCode": string,
"startAt": string,
}
}
JSON
복사
id | token의 고유 id. |
token | 요청을 보낸 token. |
certificate.id | 인증서 일련번호. |
certificate.level | 인증서 레벨. |
certificate.code | 인증서 고유번호. |
certificate.language | 인증서 취득 코딩 언어. |
certificate.expireAt | 인증서 만료 일자. YYYY-MM-DD |
certificate.email | 인증서 취득 유저 이메일. |
certificate.name | 인증서 취득 유저 이름. |
certificate.birthdate | 인증서 취득 유저 생년월일. YYYY-MM-DD |
certificate.classificationCode | 인증서 취득 시험 종류. PCCP 혹은 PCCE |
certificate.startAt | 인증서 취득일. YYYY-MM-DD’T’hh:mm:ssZ |
3. Api 호출 예시
Api request와 그에 따른 response 예시 입니다.
•
적용 정보
1.
token - 13b5af74-a70d-4ba4-b561-17fb0c9e4f1d
2.
APP ID - U5GOsv2KHGLMAK0
3.
APP Secret - nsR8I6t4EwmMN6YKkGBE8tgHA9qhxrk
•
Api request
url - https://certi.programmers.co.kr/api/v1/certificate/selected-certificates/13b5af74-a70d-4ba4-b561-17fb0c9e4f1d
metod - GET
header - Authorization : Basic VTVHT3N2MktIR0xNQUswOm5zUjhJNnQ0RXdtTU42WUtrR0JFOHRnSEE5cWh4cms=
•
Response
{
"id": 12,
"token": "13b5af74-a70d-4ba4-b561-17fb0c9e4f1d",
"certificate": {
"id": 11,
"level": 2,
"code": "asdfwdgsdg",
"language": "Python3",
"expireAt": "2029-10-08",
"email": "hong@example.co",
"name": "홍길동",
"birthdate": "1970-01-01"
"classificationCode": "PCCP",
"startAt": "2022-10-08T11:00:00Z"
}
}
JSON
복사