์๋ฅดํจํฐ๋ ์ ์ ๊ฒ์ฆ(ํ์ฅ)
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-Type | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์โ
| ์ด๋ฆ | ํ์ | ํ์ | ์ค๋ช |
|---|---|---|---|
documentType | string | ์ | ๋ฌธ์ ์ ํ. ํ์ฉ ๊ฐ: DNIAR. |
documentNumber | string | ์ | ์กฐํํ DNI ๋ฒํธ(๊ณต๋ฐฑ ์์). |
์์ฒญโ
- JavaScript
- Python
- PHP
- Swift
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);
}
import http.client
conn = http.client.HTTPSConnection("api.verifik.co")
headers = {
'Accept': "application/json",
'Authorization': "Bearer <token>"
}
conn.request(
"GET",
"/v2/ar/cedula/extra?documentType=DNIAR&documentNumber=44768756",
headers=headers
)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
<?php
$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.verifik.co/v2/ar/cedula/extra', [
'query' => [
'documentType' => 'DNIAR',
'documentNumber' => '44768756',
],
'headers' => [
'Accept' => 'application/json',
'Authorization' => 'Bearer <token>',
],
]);
echo $response->getBody();
import Foundation
let headers = [
"Accept": "application/json",
"Authorization": "Bearer <token>"
]
let request = NSMutableURLRequest(
url: NSURL(string: "https://api.verifik.co/v2/ar/cedula/extra?documentType=DNIAR&documentNumber=44768756")! as URL,
cachePolicy: .useProtocolCachePolicy,
timeoutInterval: 10.0
)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers
let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error as Any)
} else {
let httpResponse = response as? HTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()
์๋ตโ
- 200
- 404
- 409
- 409 (Invalid Type)
- 401
- 500
{
"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"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing documentType\n. missing documentNumber\n"
}
{
"code": "MissingParameter",
"message": "documentType must be one of: [DNIAR]"
}
{
"message": "Authentication required",
"code": "UNAUTHORIZED"
}
{
"code": "InternalServerError",
"message": "Server error."
}
์ฐธ๊ณ โ
documentType๋DNIAR์ฌ์ผ ํฉ๋๋ค.- ๊ฐ๋ฅํ ๊ฒฝ์ฐ
gender๋ ํ ๊ธ์ ์ฝ๋(์:F๋๋M)๋ก ๋ฐํ๋ฉ๋๋ค. isAlive๋ ์กฐํ ์ ๋ฑ๋ก๋ถ๊ฐ ํด๋น์ธ์ ์์กด์ผ๋ก ๋ณด๊ณ ํ๋์ง ๋ํ๋ ๋๋ค.
์ผ๋ฐ์ ์ธ ์ฌ์ฉ ์ฌ๋กโ
- ํํ ํฌ ๋ฐ ์ํ: ์๋ ์์ผ ๋ฐ ์์กด ์ํ ํ์ธ์ผ๋ก ์จ๋ณด๋ฉ ๊ฐํ.
- ์ ์์๊ฑฐ๋ ๋ฐ ๋ฐฐ์ก: ๋ฐฐ์ก ๊ธฐ์ฌ ๋๋ ๊ณ ๊ฐ์น ๊ณ์ ๋ณด์ ์๋ฅผ ๋ ๊ฐํ ์ ์ ์ ํธ๋ก ๊ฒ์ฆ.
- HR ๋ฐ ์ฑ์ฉ: ๊ณต์ ๊ธฐ๋ก๊ณผ ๋์กฐํ์ฌ ํ๋ณด์ ์ ์ ์ธ๋ถ ์ ๋ณด ํ์ธ.
- ๋ณดํ ๋ฐ ํฌ์ค์ผ์ด: ๊ฒ์ฆ๋ ์๋ ์์ผ๋ก ์๊ฒฉ ๋ฐ ์ฐ๋ น ๊ด๋ จ ๊ท์น ์ง์.
๊ณต์ ์ถ์ฒ ๋ฐ ์ ๋ขฐ์ฑโ
์๋ฅดํจํฐ๋ ๊ณต์ ์ ๋ถ ์ถ์ฒ์ ์ง์ ์ฐ๊ฒฐํ์ฌ ๊ฒ์ฆ๋๊ณ ์ต์ ์ ๋ณด๋ฅผ ์ ๊ณตํฉ๋๋ค. ๋ชจ๋ ์กฐํ๋ ์๊ฒฉํ ๋ณด์ ๋ฐ ๊ท์ ๊ธฐ์ค์ ๋ฐ๋ผ ์ฒ๋ฆฌ๋ฉ๋๋ค.
์ฃผ์ ์ด์ โ
- ๋ ํ๋ถํ ์ ์ ์ ํธ: ์ด๋ฆ ๋ฐ ๋ฌธ์ ๋ฒํธ ์ธ ์๋ ์์ผ, ์ฑ๋ณ, ์์กด ์ํ.
- ์๋ํ๋ ์ปดํ๋ผ์ด์ธ์ค: ์ฌ์ฉ์ ๊ฒฝํ์ ํด์น์ง ์๊ณ KYC๋ฅผ ๊ฐ์ํ.
- ์ฆ์ ๊ฒฐ๊ณผ: ์ ์ด ๋ด ์ฒ๋ฆฌ, ์ค์๊ฐ ์จ๋ณด๋ฉ์ ์ ํฉ.
- ์ ๋ขฐํ ์ ์๋ ๋ฐ์ดํฐ: ๊ณต์ ๊ธฐ๋ก์์ ์ง์ ์ทจ๋.
- ์ฌ์ด ํตํฉ: REST API ๋๋ ํธํ SDK๋ก ์ฐ๊ฒฐ.
์ปดํ๋ผ์ด์ธ์ค ๋ฐ ๋ณด์โ
๋ฐ์ดํฐ ์์ ์ ์ต์ฐ์ ์ผ๋ก ํฉ๋๋ค. Verifik์ HTTPS/TLS 1.3๊ณผ ์๊ฒฉํ ๊ฐ์ธ์ ๋ณด ๊ธฐ์ค์ ์ฌ์ฉํฉ๋๋ค. ์๋น์ค๋ 24/7 ๊ฐ์ฉ์ฑ์ ๋ชจ๋ํฐ๋งํ๋ฉฐ ์ญํ ๊ธฐ๋ฐ ์ก์ธ์ค ์ ์ด๋ฅผ ์ ๊ณตํฉ๋๋ค.
Verifik ์๊ฐโ
Verifik์ ๋ผํด ์๋ฉ๋ฆฌ์นด ์ ์ญ์ ์ ์ ํ์ธ, ์ปดํ๋ผ์ด์ธ์ค, ์ฌ๊ธฐ ๋ฐฉ์ง ์ ๋ ํ๋ซํผ์ ๋๋ค. ๋น์ฌ API๋ KYC, KYB, AML, ์์ฒด ์ธ์ฆ์ ์๋ํํ์ฌ ๊ณต์ ๋ฐ์ดํฐ ์์ค์ ๊ธฐ์ ์ ์ฐ๊ฒฐํฉ๋๋ค.