๋ณผ๋ฆฌ๋น์ ์ ์ ๊ฒ์ฆ
Verifik์ ์ ์ ํ์ธ API๋ ๊ณต์ ์ ๋ถ ๋ฐ์ดํฐ๋ฅผ ์ด์ฉํด ๋ณผ๋ฆฌ๋น์ ์๋ฏผ์ ์ธ์ฆํฉ๋๋ค. KYC(Know Your Customer) ์ ์ฐจ๋ฅผ ์๋ํํ๊ณ , ์ฌ๊ธฐ๋ฅผ ์๋ฐฉํ๋ฉฐ, ๊ท์ ์๊ตฌ์ฌํญ์ ์์ฝ๊ฒ ์ถฉ์กฑํ ์ ์๋๋ก ์ค๊ณ๋์์ต๋๋ค.
์ฌ์ฉ์, ์ง์, ๊ณ ๊ฐ์ ์ง์ง ์ ์์ ๋น ๋ฅด๊ณ ์์ ํ๊ฒ ์๋์ผ๋ก ํ์ธํด์ผ ํ๋ ๋น์ฆ๋์ค๋ฅผ ์ํด ๋ง๋ค์ด์ก์ต๋๋ค.
์ด API๋ ๋ฌด์์ ๊ฒ์ฆํฉ๋๊น?โ
๋น์ฌ์ API๋ ๊ณต์ ๊ธฐ๋ก๊ณผ ์ง์ ์ฐ๊ฒฐ๋์ด ๋ค์์ ๊ฒ์ฆํฉ๋๋ค.
- ์ ์ฒด ์ฑ๋ช ๋ฐ CI ๋ฒํธ: Cรฉdula de Identidad(CI)๋ฅผ ์ง์ํฉ๋๋ค.
- ์ ์ ์ผ์น ์ฌ๋ถ: ์ ๊ณต๋ ์ด๋ฆ์ด CI ๋ฒํธ์ ์ผ์นํ๋์ง ํ์ธํฉ๋๋ค.
- ์๋ ์์ผ ๊ฒ์ฆ: ์๋ ์์ผ์ด ๊ณต์ ๊ธฐ๋ก๊ณผ ์ผ์นํ๋์ง ํ์ธํฉ๋๋ค.
์ด๋ฌํ ํญ๋ชฉ์ ๊ฒ์ฆํจ์ผ๋ก์จ ๊ฑฐ๋ ์๋๊ฐ ์ค์กดํ๋ฉฐ ์ ํจํ ๋ฌธ์๋ฅผ ๋ณด์ ํ๊ณ ์์์ ํ์ ํ ์ ์์ต๋๋ค.
API ๋ ํผ๋ฐ์คโ
์๋ํฌ์ธํธโ
GET https://api.verifik.co/v2/bo/cedula
documentType CI, documentNumber, dateOfBirth(DD/MM/YYYY)๋ก ๋ณผ๋ฆฌ๋น์ ์๋ฏผ์ ์ ์์ ํ์ธํฉ๋๋ค. KYC ๋ฐ ์ปดํ๋ผ์ด์ธ์ค์ ํ์ฉํ ์ ์๋ ์ ์ ํ๋๋ฅผ ๋ฐํํฉ๋๋ค.
ํค๋โ
| ์ด๋ฆ | ๊ฐ |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์โ
| ์ด๋ฆ | ํ์ | ํ์ | ์ค๋ช |
|---|---|---|---|
documentType | string | ์ | ๋ฌธ์ ์ข
๋ฅ. ํ์ฉ ๊ฐ: CI. |
documentNumber | string | ์ | CI ๋ฌธ์ ๋ฒํธ. |
dateOfBirth | string | ์ | DD/MM/YYYY ํ์์ ์๋
์์ผ. |
์์ฒญโ
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/bo/cedula", {
params: { documentType: "CI", documentNumber: "123456789", dateOfBirth: "15/03/1990" },
headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/bo/cedula"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CI", "documentNumber": "123456789", "dateOfBirth": "15/03/1990"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
์๋ตโ
- 200
- 400
{
"data": {
"documentType": "CI",
"documentNumber": "123456789",
"firstName": "Marรญa",
"lastName": "Gonzรกlez",
"fullName": "Marรญa Gonzรกlez",
"dateOfBirth": "1990-03-15",
"status": "valid"
},
"signature": {"message": "Certified by Verifik.co", "dateTime": "January 16, 2024 3:44 PM"},
"id": "BO001"
}
{
"message": "Invalid document number",
"code": "INVALID_DOCUMENT"
}
์ฐธ๊ณ โ
- ์๋ ์์ผ์ ํ์์ด๋ฉฐ CI ๊ธฐ๋ก๊ณผ ์ผ์นํด์ผ ํฉ๋๋ค.
์ผ๋ฐ์ ์ธ ์ฌ์ฉ ์ฌ๋กโ
- ํํ ํฌยท์ํ: ๊ณ์ข ๊ฐ์ค์ด๋ ๋์ถ ์ ์ฒญ ์ ์ฆ์ ์ ์ ํ์ธ
- ์ด์ปค๋จธ์คยท๋ฐฐ์ก: ์ฌ์ฉ์ยท๋ฐฐ์ก์ ์ธ์ฆ
- HRยท์ฑ์ฉ: ํ๋ณด์ ๋ฌธ์ ๊ฒ์ฆ
- ๋ณดํยทํฌ์ค์ผ์ด: ๋ณดํ ๋ฐํ ์ ์ ์ ํ์ธ
๊ณต์ ์ถ์ฒ ๋ฐ ์ ๋ขฐ์ฑโ
๋ณผ๋ฆฌ๋น์ ๊ณต์ ์ ๋ถ ์ถ์ฒ์ ์ง์ ์ฐ๊ฒฐํ์ฌ ๊ฒ์ฆ๋ ์ต์ ์ ๋ณด๋ฅผ ์ ๊ณตํฉ๋๋ค.
์ฃผ์ ์ด์ โ
- ์๋ ์ปดํ๋ผ์ด์ธ์ค: KYC๋ฅผ ํจ์จํํ์ฌ ์ฌ๊ธฐ๋ฅผ ๋ฐฉ์ง
- ์ฆ์ ๊ฒฐ๊ณผ: ์ ์ด ๋ด ์กฐํ
- ์ ๋ขฐํ ์ ์๋ ๋ฐ์ดํฐ: ๊ณต์ ๊ธฐ๋ก ๊ธฐ๋ฐ
์ปดํ๋ผ์ด์ธ์ค ๋ฐ ๋ณด์โ
HTTPS/TLS๋ฅผ ํตํ ํต์ ๋ณดํธ์ ์๊ฒฉํ ๊ฐ์ธ์ ๋ณด ๊ด๋ฆฌ๋ฅผ ์ค์ํฉ๋๋ค.
Verifik ์๊ฐโ
Verifik๋ ๋ผํด์๋ฉ๋ฆฌ์นด ์ ์ญ์์ ์ ์ ํ์ธ, ์ปดํ๋ผ์ด์ธ์ค, ์ฌ๊ธฐ ๋ฐฉ์ง๋ฅผ ์ํ ํ๋ซํผ์ ๋๋ค.