Skip to main content

๐Ÿ‡จ๐Ÿ‡ด ์ฝœ๋กฌ๋น„์•„ โ€” 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)โ€‹

์ด๋ฆ„๊ฐ’
Acceptapplication/json
AuthorizationBearer <token>

๋งค๊ฐœ๋ณ€์ˆ˜(Parameters)โ€‹

nametyperequireddescription
documentTypestringyesCC, TI, CE, PA, RC, PEP ์ค‘ ํ•˜๋‚˜.
documentNumberstringyes๊ณต๋ฐฑยท๊ตฌ๋‘์  ์—†์ด ์ž…๋ ฅํ•˜๋Š” ์‹ ๋ถ„์ฆ ๋ฒˆํ˜ธ.

์š”์ฒญ(Request)โ€‹

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);

์‘๋‹ต(Response)โ€‹

{
"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"
}
}

๊ธฐ๋Šฅโ€‹

  • ์‹ ๋ถ„์ฆ ์œ ํ˜•: CC, TI, CE, PA, RC, PEP
  • GET ์ฟผ๋ฆฌ ๋งค๊ฐœ๋ณ€์ˆ˜
  • SENA ๊ธฐ๋ก์ด ์—ฌ๋Ÿฌ ๊ฐœ์ธ ๊ฒฝ์šฐ ์—ฌ๋Ÿฌ ํ–‰ ๋ฐ˜ํ™˜

์‚ฌ์šฉ ์‚ฌ๋ก€โ€‹

  • ๊ธฐ์ˆ  ์—ญ๋Ÿ‰ ๋ฐ ์ง์—… ๊ต์œก ๊ฒ€์ฆ
  • ๊ณ ์šฉ ์‹ค์‚ฌ ๋ฐ ํ•˜๋„๊ธ‰์—…์ฒด ์˜จ๋ณด๋”ฉ
  • SENA ์ž๊ฒฉ์ด ํ•„์š”ํ•œ ์ง๋ฌด์˜ ๊ต์œก ์ปดํ”Œ๋ผ์ด์–ธ์Šค

์ฐธ๊ณ โ€‹

  • SENA๊ฐ€ ์ฆ๋ช…์„œ ์—†์Œ์„ ๋ณด๊ณ ํ•˜๋ฉด 404(ใ€ŒNo se ha encontrado certificadosใ€).
  • ์ƒŒ๋“œ๋ฐ•์Šค: documentNumber 10000001โ€“10000010 ๊ณ ์ • ์ƒ˜ํ”Œ, 90040401 โ†’ 404.
  • ๋ฏธ๋“ค์›จ์–ด๋Š” ํ˜„์žฌ CC์™€ NIT๋งŒ ๊ฒ€์ฆ. ์นดํƒˆ๋กœ๊ทธ์˜ ๋‹ค๋ฅธ ์œ ํ˜•์€ SENA ํฌํ„ธ ์ง€์›์— ๋”ฐ๋ฆ„.
  • ํฌํ„ธ ๊ฐ€์šฉ์„ฑ ๋ฐ CAPTCHA๋Š” ํ™˜๊ฒฝ ์˜์กด. 5xx ๊ฐ€๋Šฅ.
  • ์ฝœ๋กฌ๋น„์•„ ๋ฒ• ๋ฐ ์ •์ฑ…์— ๋”ฐ๋ผ ๊ฐœ์ธยท๊ต์œก ๋ฐ์ดํ„ฐ๋กœ ์ฒ˜๋ฆฌํ•˜์„ธ์š”.