๐จ๐ฑ ์น ๋ โ ์ด์ ๋ฉดํ
๋ณธ ์๋น์ค๋ ์ด์ ๋ฉดํ ๋ฒํธ๋ฅผ ์ฟผ๋ฆฌ ๋งค๊ฐ๋ณ์๋ก ์ฌ์ฉํ์ฌ ์น ๋ ์ด์ ๋ฉดํ์ ๋ํ ์์ธ ์ ๋ณด๋ฅผ ์กฐํํ ์ ์๋๋ก ํฉ๋๋ค. RUT(๊ณ ์ ๋ฉ์ธ์ ๋ฒํธ), ์ฃผ์, ๋ฉดํ ๋ฑ๊ธ, ํต์ ์ผ์ ๋ฑ ์ด์ ๋ฉดํ์ ๊ด๋ จ๋ ํต์ฌ ๋ฐ์ดํฐ๋ฅผ ๊ตฌ์กฐํ๋ ํ์์ผ๋ก ์ ๊ณตํฉ๋๋ค.
์๋ํฌ์ธํธโ
GET https://api.verifik.co/v2/cl/driver-license
์น ๋ ์ด์ ๋ฉดํ๋ฅผ ๋ฉดํ ๋ฒํธ(์ฟผ๋ฆฌ documentNumber)๋ก ์กฐํํฉ๋๋ค. ๋ฑ๊ธฐ์ ๊ฐ์ฉ์ฑ์ ๋ฐ๋ผ ์ผ๋ฐ์ ์ผ๋ก RUT, ๋ฉดํ ๋ฑ๊ธ, ์ ํ ์ฌํญ, ํต์ ์ผ์, ์์น๊ตฌ, ์ฃผ์ ํ๋๊ฐ ๋ฐํ๋ฉ๋๋ค. ์ด์ ์๊ฒฉ์ด ์ค์ํ ์ฐจ๋, ์ธ๋ ฅ, KYC ์ ๊ฒ์ ์ ํฉํฉ๋๋ค.
ํค๋(Headers)โ
| ์ด๋ฆ | ๊ฐ |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์(Parameters)โ
| ์ด๋ฆ | ํ์ | ํ์ | ์ค๋ช | ์์ |
|---|---|---|---|---|
documentNumber | string | ์ | ์กฐํํ ๋ฉดํ ๋ฒํธ. ๊ณต๋ฐฑ์ด๋ ์ ์์ด ์ ๋ ฅํฉ๋๋ค. | 12345678 |
์์ฒญ(Request)โ
- JavaScript
- Python
- PHP
- Swift
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.verifik.co/v2/cl/driver-license',
params: {
documentNumber: '12345678'
},
headers: {
'Accept': 'application/json',
'Authorization': 'Bearer <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")
payload = ''
headers = {
"Accept": "application/json",
"Authorization": "Bearer <tu_token>",
}
conn.request("GET", "/v2/cl/driver-license?documentNumber=12345678", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/cl/driver-license?documentNumber=12345678');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setHeader('Accept', 'application/json');
$request->setHeader('Authorization', 'Bearer <tu_token>');
$request->setConfig(array(
'follow_redirects' => TRUE
));
try {
$response = $request->send();
if ($response->getStatus() == 200) {
echo $response->getBody();
}
else {
echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
$response->getReasonPhrase();
}
}
catch(HTTP_Request2_Exception $e) {
echo 'Error: ' . $e->getMessage();
}
?>
var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/cl/driver-license?documentNumber=12345678")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("Bearer <tu_token>", forHTTPHeaderField: "Authorization")
let task = URLSession.shared.dataTask(with: request) { data, response, error in
guard let data = data else {
print(String(describing: error))
return
}
print(String(data: data, encoding: .utf8)!)
}
task.resume()
์๋ต(Response)โ
- 200
- 404
- 409
{
"data": {
"RUT": "12.345.678-9",
"address": "PEDRO LEON UGALDE 1825",
"class": "B",
"controlDate": "23/08/2009",
"documentNumber": "012345678",
"lastControlDate": "15/07/2003",
"lastName": "VERIFIK",
"license": "CA-12345678",
"municipality": "SANTIAGO",
"names": "MATEO",
"procedure": "DUPLICADO",
"restrictions": ".USAR LENTES O DE CONTACTO. "
},
"signature": {
"dateTime": "November 2, 2023 3:12 PM",
"message": "Certified by Verifik.co"
},
"id": "1tm6q"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing documentNumber\n"
}
์ฃผ์ ๊ธฐ๋ฅโ
- RUT ๊ฒ์ฆ: ์น ๋ ๋ฉ์ธ์ ๋ฒํธ์ ์ง์๋ฅผ ํ์ธํฉ๋๋ค.
- ๋ฉดํ ๋ฑ๊ธ ์ ๋ณด: ๋ฉดํ ๋ฑ๊ธ(A, B, C ๋ฑ)์ ๋ํ ์์ธ ์ ๋ณด๋ฅผ ์ ๊ณตํฉ๋๋ค.
- ํต์ ์ผ์: ๋ฉดํ ํต์ ์ผ์์ ๋ง์ง๋ง ํต์ ์ผ์๋ฅผ ์ ๊ณตํฉ๋๋ค.
- ์ด์ ์ ์ ๋ณด: ์ด์ ์์ ์ด๋ฆ, ์ฃผ์, ์์น๊ตฌ๋ฅผ ์กฐํํ ์ ์์ต๋๋ค.
- ๋ฉดํ ์ ํ ์ฌํญ: ์ด์ ์ ํ ์ฌํญ์ ๋ํ ์ ๋ณด๋ฅผ ์ ๊ณตํฉ๋๋ค.
- ์ ์ฐจ ์ ๋ณด: ๋ฉดํ ๋ฐ๊ธ ์ ์ฐจ(์ฌ๋ฐ๊ธ, ๊ฐฑ์ ๋ฑ) ์์ธ ์ ๋ณด๋ฅผ ์ ๊ณตํฉ๋๋ค.
- ๋ค์ํ ํ๋ก๊ทธ๋๋ฐ ์ธ์ด ์ง์: JavaScript, Python, PHP, Swift ์์ ๋ฅผ ์ ๊ณตํฉ๋๋ค.
- ์ค์๊ฐ ๋ฐ์ดํฐ: ์ต์ ์ ์ด์ ๋ฉดํ ์ ๋ณด๋ฅผ ์กฐํํ ์ ์์ต๋๋ค.
- ์ข ํฉ ์ค๋ฅ ์ฒ๋ฆฌ: ๋ค์ํ ์๋๋ฆฌ์ค์ ๋ํ ์์ธํ ์ค๋ฅ ์๋ต์ ์ ๊ณตํฉ๋๋ค.
- ๊ตฌ์กฐํ๋ ์๋ต: ์๋ช ๊ฒ์ฆ์ ํฌํจํ ์ ์ ๋ฆฌ๋ JSON ์๋ต์ ์ ๊ณตํฉ๋๋ค.
- ์น ๋ ๋ฑ๊ธฐ์ ์ฐ๋: ๊ณต์ ์น ๋ ์ด์ ๋ฉดํ ๋ฐ์ดํฐ๋ฒ ์ด์ค์ ์ง์ ์ ๊ทผํฉ๋๋ค.