๐จ๐ด ์ฝ๋กฌ๋น์ โ SENA ์ฆ๋ช ์
๋ณธ ์๋ํฌ์ธํธ๋ ์ฝ๋กฌ๋น์ ๊ตญ๋ฏผ์ SENA(Servicio Nacional de Aprendizaje) ๊ต์ก ๋ฐ ์ธ์ฆ ๊ธฐ๋ก์ ๋ฐํํฉ๋๋ค. SENA ๊ณต์ ๋์งํธ ์ฆ๋ช ์ ํฌํธ์์ ๊ฐ์ ธ์ต๋๋ค. ๊ฐ ํ์๋ ํ๋ก๊ทธ๋จ๋ช , ์ธ์ฆ ์ ํ, ๋ฐ๊ธ์ผ ๋ฐ ๊ฐ๋ฅํ ๊ฒฝ์ฐ ๋์งํธ ์ฆ๋ช ์ ๋ค์ด๋ก๋ URL์ด ํฌํจ๋ฉ๋๋ค.
์ฑ์ฉ ์ฌ์ฌ, ๊ธฐ์ ๊ฒ์ฆ, ๊ต์ก ์ปดํ๋ผ์ด์ธ์ค ํ์ธ์ ์ฌ์ฉํ ์ ์์ต๋๋ค.
๋ฐํ ๋ฐ์ดํฐโ
data์๋ ์ฆ๋ช ์ ํ ๋ฐฐ์ด(record,title,type,program,certificationDate,certificationSignature,certificateDownload)- Verifik ์๋ช ์ด ํฌํจ๋ ์๋ต
API ๋ ํผ๋ฐ์คโ
์๋ํฌ์ธํธโ
GET https://api.verifik.co/v2/co/sena/certificados
GET๋ง ์ง์. ์ฟผ๋ฆฌ ๋งค๊ฐ๋ณ์๋ง ์ฌ์ฉ.
์ฟผ๋ฆฌ: documentType, documentNumber.
ํค๋(Headers)โ
| ์ด๋ฆ | ๊ฐ |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์(Parameters)โ
| name | type | required | description |
|---|---|---|---|
documentType | string | yes | CC, TI, CE, PA, RC, PEP ์ค ํ๋. |
documentNumber | string | yes | ๊ณต๋ฐฑยท๊ตฌ๋์ ์์ด ์ ๋ ฅํ๋ ์ ๋ถ์ฆ ๋ฒํธ. |
์์ฒญ(Request)โ
- JavaScript
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/sena/certificados", {
params: {
documentType: "CC",
documentNumber: "1234567890",
},
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/co/sena/certificados"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CC", "documentNumber": "1234567890"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
์๋ต(Response)โ
- 200
- 404
- 409
{
"data": [
{
"record": "1",
"title": "TรCNICO EN SISTEMAS",
"type": "TITULO",
"program": "ANALISIS Y DESARROLLO DE SOFTWARE",
"certificationDate": "15/06/2019",
"certificationSignature": "SIG-EXAMPLE",
"certificateDownload": "https://certificados.sena.edu.co/CertificadoDigital/cert-example.pdf"
}
],
"signature": {
"dateTime": "January 16, 2024 3:44 PM",
"message": "Certified by Verifik.co"
}
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "documentType must be one of [CC, NIT]"
}
๊ธฐ๋ฅโ
- ์ ๋ถ์ฆ ์ ํ: CC, TI, CE, PA, RC, PEP
- GET ์ฟผ๋ฆฌ ๋งค๊ฐ๋ณ์
- SENA ๊ธฐ๋ก์ด ์ฌ๋ฌ ๊ฐ์ธ ๊ฒฝ์ฐ ์ฌ๋ฌ ํ ๋ฐํ
์ฌ์ฉ ์ฌ๋กโ
- ๊ธฐ์ ์ญ๋ ๋ฐ ์ง์ ๊ต์ก ๊ฒ์ฆ
- ๊ณ ์ฉ ์ค์ฌ ๋ฐ ํ๋๊ธ์ ์ฒด ์จ๋ณด๋ฉ
- SENA ์๊ฒฉ์ด ํ์ํ ์ง๋ฌด์ ๊ต์ก ์ปดํ๋ผ์ด์ธ์ค
์ฐธ๊ณ โ
- SENA๊ฐ ์ฆ๋ช ์ ์์์ ๋ณด๊ณ ํ๋ฉด 404(ใNo se ha encontrado certificadosใ).
- ์๋๋ฐ์ค:
documentNumber10000001โ10000010๊ณ ์ ์ํ,90040401โ 404. - ๋ฏธ๋ค์จ์ด๋ ํ์ฌ CC์ NIT๋ง ๊ฒ์ฆ. ์นดํ๋ก๊ทธ์ ๋ค๋ฅธ ์ ํ์ SENA ํฌํธ ์ง์์ ๋ฐ๋ฆ.
- ํฌํธ ๊ฐ์ฉ์ฑ ๋ฐ CAPTCHA๋ ํ๊ฒฝ ์์กด. 5xx ๊ฐ๋ฅ.
- ์ฝ๋กฌ๋น์ ๋ฒ ๋ฐ ์ ์ฑ ์ ๋ฐ๋ผ ๊ฐ์ธยท๊ต์ก ๋ฐ์ดํฐ๋ก ์ฒ๋ฆฌํ์ธ์.