์๋ฅดํจํฐ๋ ์ ์ ๊ฒ์ฆ
Verifik์ ์ ์ ํ์ธ API๋ ๊ณต์ ์ ๋ถ ๋ฐ์ดํฐ๋ฅผ ์ฌ์ฉํด ์๋ฅดํจํฐ๋ ๊ตญ๋ฏผ์ ์ธ์ฆํ ์ ์๋๋ก ํฉ๋๋ค. KYC(Know Your Customer) ์ ์ฐจ๋ฅผ ์๋ํํ๊ณ , ์ฌ๊ธฐ๋ฅผ ์๋ฐฉํ๋ฉฐ, ๊ท์ ์๊ตฌ์ฌํญ์ ์์ฝ๊ฒ ์ถฉ์กฑํ ์ ์๋๋ก ์ค๊ณ๋์์ต๋๋ค.
์ฌ์ฉ์, ์ง์, ๊ณ ๊ฐ์ ์ง์ง ์ ์์ ๋น ๋ฅด๊ณ ์์ ํ๊ฒ ์๋์ผ๋ก ํ์ธํด์ผ ํ๋ ๋น์ฆ๋์ค๋ฅผ ์ํด ๋ง๋ค์ด์ก์ต๋๋ค.
์ด API๋ ๋ฌด์์ ๊ฒ์ฆํฉ๋๊น?โ
๋น์ฌ API๋ ๊ณต์ ๊ธฐ๋ก๊ณผ ์ง์ ์ฐ๊ฒฐ๋์ด ๋ค์์ ๊ฒ์ฆํฉ๋๋ค.
- ์ฑ๋ช ๋ฐ DNI ๋ฒํธ: Documento Nacional de Identidad(DNI)๋ฅผ ์ง์ํฉ๋๋ค.
- ์ ์ ์ผ์น: ์ ๊ณต๋ ์ด๋ฆ์ด DNI ๋ฒํธ์ ์ผ์นํ๋์ง ํ์ธํฉ๋๋ค.
์ด๋ฌํ ํญ๋ชฉ์ ๊ฒ์ฆํจ์ผ๋ก์จ ๊ฑฐ๋ ์๋๊ฐ ์ค์กดํ๋ฉฐ ์ ํจํ ๋ฌธ์๋ฅผ ๋ณด์ ํ๊ณ ์์์ ํ์ ํ ์ ์๊ณ , ์ ์ ๋์ฉ ๋ฐ ์ฌ๊ธฐ ์ํ์ ํฌ๊ฒ ๋ฎ์ถ ์ ์์ต๋๋ค.
API ๋ ํผ๋ฐ์คโ
์๋ํฌ์ธํธโ
GET https://api.verifik.co/v2/ar/cedula
documentType DNIAR์ **documentNumber**๋ก ์๋ฅดํจํฐ๋ ์ ์์ ๊ฒ์ฆํฉ๋๋ค. KYC ๋ฐ ์ปดํ๋ผ์ด์ธ์ค๋ฅผ ์ง์ํ๋ ์ ์ ํ๋๋ฅผ ๋ฐํํฉ๋๋ค.
ํค๋โ
| ์ด๋ฆ | ๊ฐ |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์โ
| ์ด๋ฆ | ํ์ | ํ์ | ์ค๋ช |
|---|---|---|---|
documentType | string | ์ | ๋ฌธ์ ์ ํ. ํ์ฉ ๊ฐ: DNIAR. |
documentNumber | string | ์ | ์กฐํํ ์ฌ๋์ ๋ฌธ์ ๋ฒํธ(๊ณต๋ฐฑ ์์). |
์์ฒญโ
- JavaScript
- Python
- PHP
- Swift
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.verifik.co/v2/ar/cedula',
params: {documentType: 'DNIAR', documentNumber: '123456789'},
headers: {
Accept: 'application/json',
Authorization: 'jwt <tu_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': "JWT token"
}
conn.request("GET", "/v2/ar/cedula?documentType=DNIAR&documentNumber=123456789", 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?documentType=DNIAR&documentNumber=123456789', [
'headers' => [
'Accept' => 'application/json',
'Authorization' => 'JWT token',
],
]);
echo $response->getBody();
import Foundation
let headers = [
"Accept": "application/json",
"Authorization": "JWT token"
]
let request = NSMutableURLRequest(url: NSURL(string: "https://api.verifik.co/v2/ar/cedula?documentType=DNIAR&documentNumber=123456789")! 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)
{
"data": {
"documentType": "CCAR",
"documentNumber": "123456789",
"fullName": "MATEO VERIFIK",
"firstName": "MATEO",
"lastName": "VERIFIK",
"arrayName": [
"MATEO",
"VERIFIK"
]
},
"signature": {
"dateTime": "April 11, 2023 12:25 PM",
"message": "Certified by Verifik.co"
}
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing documentType\n. missing documentNumber\n"
}
{
"code": "MissingParameter",
"message": "documentType must be one of: [DNIAR]"
}
์ผ๋ฐ์ ์ธ ์ฌ์ฉ ์ฌ๋กโ
- ํํ ํฌ ๋ฐ ์ํ: ๊ณ์ข ๊ฐ์ค ๋๋ ๋์ถ ์ ์ฒญ ์ ์ฆ์ ์ ์์ ๊ฒ์ฆํฉ๋๋ค.
- ์ ์์๊ฑฐ๋ ๋ฐ ๋ฐฐ์ก: ์ฌ์ฉ์์ ๋ฐฐ์ก ๊ธฐ์ฌ๋ฅผ ํ์ฑํํ๊ธฐ ์ ์ ์ธ์ฆํฉ๋๋ค.
- HR ๋ฐ ์ฑ์ฉ: ์ฑ์ฉ ์ํฌํ๋ก์ ์ผ๋ถ๋ก ํ๋ณด์ ๋ฌธ์๋ฅผ ๊ฒ์ฆํฉ๋๋ค.
- ๋ณดํ ๋ฐ ํฌ์ค์ผ์ด: ๋ณดํ ๋ฐ๊ธ ๋๋ ํํ ์ ๊ณต ์ ์ ์ ์์ ํ์ธํฉ๋๋ค.
๊ณต์ ์ถ์ฒ ๋ฐ ์ ๋ขฐ์ฑโ
์๋ฅดํจํฐ๋ ๊ณต์ ์ ๋ถ ์ถ์ฒ์ ์ง์ ์ฐ๊ฒฐํ์ฌ ๊ฒ์ฆ๋๊ณ ์ต์ ์ ๋ณด๋ฅผ ์ ๊ณตํฉ๋๋ค. ๋ชจ๋ ์กฐํ๋ ์๊ฒฉํ ๋ณด์ ๋ฐ ๊ท์ ๊ธฐ์ค์ ๋ฐ๋ผ ์ฒ๋ฆฌ๋ฉ๋๋ค.
์ฃผ์ ์ด์ โ
- ์๋ํ๋ ์ปดํ๋ผ์ด์ธ์ค: ์ฌ์ฉ์ ๊ฒฝํ์ ํด์น์ง ์๊ณ KYC ๊ฒ์ฌ๋ฅผ ๊ฐ์ํํ์ฌ ์ฌ๊ธฐ๋ฅผ ์๋ฐฉํฉ๋๋ค.
- ์ฆ์ ๊ฒฐ๊ณผ: ์ ์ด ๋ด์ ๊ฒ์ฆ์ ์ฒ๋ฆฌํ์ฌ ์ค์๊ฐ ๋์งํธ ์จ๋ณด๋ฉ์ ์ ํฉํฉ๋๋ค.
- ์ ๋ขฐํ ์ ์๋ ๋ฐ์ดํฐ: ๊ณต์ ๊ธฐ๋ก์์ ์ง์ ๊ฐ์ ธ์จ ๋ฐ์ดํฐ๋ฅผ ์ฌ์ฉํฉ๋๋ค.
- ์ฌ์ด ํตํฉ: REST API ๋๋ ํธํ SDK๋ฅผ ํตํด ์ฝ๊ฒ ์ฐ๊ฒฐํ ์ ์์ต๋๋ค.
์ปดํ๋ผ์ด์ธ์ค ๋ฐ ๋ณด์โ
๋ฐ์ดํฐ ์์ ์ ์ต์ฐ์ ์ผ๋ก ํฉ๋๋ค. Verifik์ ๊ณ ๊ธ ์ํธํ(HTTPS/TLS 1.3)์ ์๊ฒฉํ ๊ฐ์ธ์ ๋ณด ๊ด๋ฆฌ ๊ธฐ์ค์ ์ฌ์ฉํ์ฌ ๊ธฐ๋ฐ์ฑ์ ๋ณด์ฅํฉ๋๋ค. ์๋น์ค๋ 24/7 ๊ฐ์ฉ์ฑ์ ๋ชจ๋ํฐ๋งํ๋ฉฐ, ํ ์ ๊ทผ์ ์์ ํ๊ฒ ์ ์งํ๋ ์ญํ ๊ธฐ๋ฐ ์ก์ธ์ค ์ ์ด๋ฅผ ์ ๊ณตํฉ๋๋ค.
Verifik ์๊ฐโ
Verifik์ ๋ผํด ์๋ฉ๋ฆฌ์นด ์ ์ญ์์ ์ ์ ํ์ธ, ์ปดํ๋ผ์ด์ธ์ค, ์ฌ๊ธฐ ๋ฐฉ์ง๋ฅผ ์ํ ์ ๋ ํ๋ซํผ์ ๋๋ค. ๋น์ฌ API๋ KYC, KYB, AML ๋ฐ ์์ฒด ์ธ์ฆ ํ๋ก์ธ์ค๋ฅผ ์๋ํํ์ฌ ๊ธฐ์ ์ ์ฝ๋กฌ๋น์, ๋ฉ์์ฝ, ํ๋ฃจ, ์น ๋ , ์ฐ๋ฃจ๊ณผ์ด, ์๋ฅดํจํฐ๋ ๋ฑ์ ๊ณต์ ๋ฐ์ดํฐ ์์ค์ ์ฐ๊ฒฐํฉ๋๋ค.