Skip to main content

์•„๋ฅดํ—จํ‹ฐ๋‚˜ ์‹ ์› ๊ฒ€์ฆ(ํ™•์žฅ)

Verifik ์‹ ์› ํ™•์ธ API๋Š” ๊ณต์‹ ์ •๋ถ€ ๋ฐ์ดํ„ฐ๋กœ ์•„๋ฅดํ—จํ‹ฐ๋‚˜ ๊ตญ๋ฏผ์„ ์ธ์ฆํ•ฉ๋‹ˆ๋‹ค. ์ด ์—”๋“œํฌ์ธํŠธ๋Š” ํ‘œ์ค€ cรฉdula ์‘๋‹ต์„ ๋„˜์–ด ์ƒ๋…„์›”์ผ, ์„ฑ๋ณ„, ๊ตฌ์กฐํ™”๋œ ์ด๋ฆ„ ํ† ํฐ, ์ƒ์กด ์ƒํƒœ(isAlive)๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

์ด API๋Š” ๋ฌด์—‡์„ ๊ฒ€์ฆํ•ฉ๋‹ˆ๊นŒ?โ€‹

๋‹น์‚ฌ API๋Š” ๊ณต์‹ ๊ธฐ๋ก๊ณผ ์ง์ ‘ ์—ฐ๊ฒฐ๋˜์–ด ๋‹ค์Œ์„ ๊ฒ€์ฆํ•ฉ๋‹ˆ๋‹ค.

  • ์„ฑ๋ช… ๋ฐ DNI ๋ฒˆํ˜ธ: Documento Nacional de Identidad(DNI), ๋ฌธ์„œ ์œ ํ˜• DNIAR ์ง€์›.
  • ์‹ ์› ์ผ์น˜: ๋ฌธ์„œ ๋ฒˆํ˜ธ๊ฐ€ ๋“ฑ๋ก๋œ ์‚ฌ๋žŒ๊ณผ ์ผ์น˜ํ•˜๋Š”์ง€ ํ™•์ธ.
  • ์ถ”๊ฐ€ ๋ฐ์ดํ„ฐ: dateOfBirth, gender, firstName, lastName, fullName, arrayName(์ด๋ฆ„ ํŒŒํŠธ), isAlive ๋ฐ˜ํ™˜.

์ด๋ฅผ ๊ฒ€์ฆํ•˜๋ฉด ์ƒ๋Œ€๋ฐฉ์ด ์‹ค์กดํ•˜๋ฉฐ ์œ ํšจํ•œ ๋ฌธ์„œ๋ฅผ ๋ณด์œ ํ•˜๊ณ  ์žˆ์Œ์„ ํ™•์‹ ํ•  ์ˆ˜ ์žˆ์–ด ์‹ ์› ๋„์šฉ ๋ฐ ์‚ฌ๊ธฐ ์œ„ํ—˜์„ ํฌ๊ฒŒ ๋‚ฎ์ถœ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

API ๋ ˆํผ๋Ÿฐ์Šคโ€‹

์—”๋“œํฌ์ธํŠธโ€‹

https://api.verifik.co/v2/ar/cedula/extra

ํ—ค๋”โ€‹

์ด๋ฆ„๊ฐ’
Content-Typeapplication/json
AuthorizationBearer <token>

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

์ด๋ฆ„ํ˜•์‹ํ•„์ˆ˜์„ค๋ช…
documentTypestring์˜ˆ๋ฌธ์„œ ์œ ํ˜•. ํ—ˆ์šฉ ๊ฐ’: DNIAR.
documentNumberstring์˜ˆ์กฐํšŒํ•  DNI ๋ฒˆํ˜ธ(๊ณต๋ฐฑ ์—†์Œ).

์š”์ฒญโ€‹

import axios from 'axios';

const options = {
method: 'GET',
url: 'https://api.verifik.co/v2/ar/cedula/extra',
params: { documentType: 'DNIAR', documentNumber: '44768756' },
headers: {
Accept: 'application/json',
Authorization: 'Bearer <token>',
},
};

try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}

์‘๋‹ตโ€‹

{
"data": {
"documentType": "DNIAR",
"documentNumber": "44768756",
"firstName": "MARIA LOURDES",
"lastName": "ARCE",
"fullName": "MARIA LOURDES ARCE",
"arrayName": [
"MARIA",
"LOURDES",
"ARCE"
],
"gender": "F",
"dateOfBirth": "2003-03-25",
"isAlive": true
},
"signature": {
"dateTime": "April 15, 2026 5:43 PM",
"message": "Certified by Verifik.co"
},
"id": "B7T6Y"
}

์ฐธ๊ณ โ€‹

  • documentType๋Š” DNIAR์—ฌ์•ผ ํ•ฉ๋‹ˆ๋‹ค.
  • ๊ฐ€๋Šฅํ•œ ๊ฒฝ์šฐ gender๋Š” ํ•œ ๊ธ€์ž ์ฝ”๋“œ(์˜ˆ: F ๋˜๋Š” M)๋กœ ๋ฐ˜ํ™˜๋ฉ๋‹ˆ๋‹ค.
  • isAlive๋Š” ์กฐํšŒ ์‹œ ๋“ฑ๋ก๋ถ€๊ฐ€ ํ•ด๋‹น์ธ์„ ์ƒ์กด์œผ๋กœ ๋ณด๊ณ ํ•˜๋Š”์ง€ ๋‚˜ํƒ€๋ƒ…๋‹ˆ๋‹ค.

์ผ๋ฐ˜์ ์ธ ์‚ฌ์šฉ ์‚ฌ๋ก€โ€‹

  • ํ•€ํ…Œํฌ ๋ฐ ์€ํ–‰: ์ƒ๋…„์›”์ผ ๋ฐ ์ƒ์กด ์ƒํƒœ ํ™•์ธ์œผ๋กœ ์˜จ๋ณด๋”ฉ ๊ฐ•ํ™”.
  • ์ „์ž์ƒ๊ฑฐ๋ž˜ ๋ฐ ๋ฐฐ์†ก: ๋ฐฐ์†ก ๊ธฐ์‚ฌ ๋˜๋Š” ๊ณ ๊ฐ€์น˜ ๊ณ„์ • ๋ณด์œ ์ž๋ฅผ ๋” ๊ฐ•ํ•œ ์‹ ์› ์‹ ํ˜ธ๋กœ ๊ฒ€์ฆ.
  • HR ๋ฐ ์ฑ„์šฉ: ๊ณต์‹ ๊ธฐ๋ก๊ณผ ๋Œ€์กฐํ•˜์—ฌ ํ›„๋ณด์ž ์‹ ์› ์„ธ๋ถ€ ์ •๋ณด ํ™•์ธ.
  • ๋ณดํ—˜ ๋ฐ ํ—ฌ์Šค์ผ€์–ด: ๊ฒ€์ฆ๋œ ์ƒ๋…„์›”์ผ๋กœ ์ž๊ฒฉ ๋ฐ ์—ฐ๋ น ๊ด€๋ จ ๊ทœ์น™ ์ง€์›.

๊ณต์‹ ์ถœ์ฒ˜ ๋ฐ ์‹ ๋ขฐ์„ฑโ€‹

์•„๋ฅดํ—จํ‹ฐ๋‚˜ ๊ณต์‹ ์ •๋ถ€ ์ถœ์ฒ˜์™€ ์ง์ ‘ ์—ฐ๊ฒฐํ•˜์—ฌ ๊ฒ€์ฆ๋˜๊ณ  ์ตœ์‹  ์ •๋ณด๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ๋ชจ๋“  ์กฐํšŒ๋Š” ์—„๊ฒฉํ•œ ๋ณด์•ˆ ๋ฐ ๊ทœ์ œ ๊ธฐ์ค€์— ๋”ฐ๋ผ ์ฒ˜๋ฆฌ๋ฉ๋‹ˆ๋‹ค.

์ฃผ์š” ์ด์ โ€‹

  • ๋” ํ’๋ถ€ํ•œ ์‹ ์› ์‹ ํ˜ธ: ์ด๋ฆ„ ๋ฐ ๋ฌธ์„œ ๋ฒˆํ˜ธ ์™ธ ์ƒ๋…„์›”์ผ, ์„ฑ๋ณ„, ์ƒ์กด ์ƒํƒœ.
  • ์ž๋™ํ™”๋œ ์ปดํ”Œ๋ผ์ด์–ธ์Šค: ์‚ฌ์šฉ์ž ๊ฒฝํ—˜์„ ํ•ด์น˜์ง€ ์•Š๊ณ  KYC๋ฅผ ๊ฐ„์†Œํ™”.
  • ์ฆ‰์‹œ ๊ฒฐ๊ณผ: ์ˆ˜ ์ดˆ ๋‚ด ์ฒ˜๋ฆฌ, ์‹ค์‹œ๊ฐ„ ์˜จ๋ณด๋”ฉ์— ์ ํ•ฉ.
  • ์‹ ๋ขฐํ•  ์ˆ˜ ์žˆ๋Š” ๋ฐ์ดํ„ฐ: ๊ณต์‹ ๊ธฐ๋ก์—์„œ ์ง์ ‘ ์ทจ๋“.
  • ์‰ฌ์šด ํ†ตํ•ฉ: REST API ๋˜๋Š” ํ˜ธํ™˜ SDK๋กœ ์—ฐ๊ฒฐ.

์ปดํ”Œ๋ผ์ด์–ธ์Šค ๋ฐ ๋ณด์•ˆโ€‹

๋ฐ์ดํ„ฐ ์•ˆ์ „์„ ์ตœ์šฐ์„ ์œผ๋กœ ํ•ฉ๋‹ˆ๋‹ค. Verifik์€ HTTPS/TLS 1.3๊ณผ ์—„๊ฒฉํ•œ ๊ฐœ์ธ์ •๋ณด ๊ธฐ์ค€์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ์„œ๋น„์Šค๋Š” 24/7 ๊ฐ€์šฉ์„ฑ์„ ๋ชจ๋‹ˆํ„ฐ๋งํ•˜๋ฉฐ ์—ญํ•  ๊ธฐ๋ฐ˜ ์•ก์„ธ์Šค ์ œ์–ด๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

Verifik ์†Œ๊ฐœโ€‹

Verifik์€ ๋ผํ‹ด ์•„๋ฉ”๋ฆฌ์นด ์ „์—ญ์˜ ์‹ ์› ํ™•์ธ, ์ปดํ”Œ๋ผ์ด์–ธ์Šค, ์‚ฌ๊ธฐ ๋ฐฉ์ง€ ์„ ๋„ ํ”Œ๋žซํผ์ž…๋‹ˆ๋‹ค. ๋‹น์‚ฌ API๋Š” KYC, KYB, AML, ์ƒ์ฒด ์ธ์ฆ์„ ์ž๋™ํ™”ํ•˜์—ฌ ๊ณต์‹ ๋ฐ์ดํ„ฐ ์†Œ์Šค์™€ ๊ธฐ์—…์„ ์—ฐ๊ฒฐํ•ฉ๋‹ˆ๋‹ค.