์ ๋กํด ๋ฐฐ๊ฒฝ ์กฐํ
API ๋ ํผ๋ฐ์คโ
์๋ํฌ์ธํธโ
https://api.verifik.co/v2/europol
documentType๊ณผ documentNumber, ๋๋ fullName๋ง์ผ๋ก ์ ๋กํด ํ์ฌ ๊ธฐ๋ก ๋ฐ์ดํฐ๋ฅผ ์ค์๊ฐ์ผ๋ก ์กฐํํฉ๋๋ค. ์๋ต์ ์ผ์น ์ฌ๋ถ๋ฅผ ๋ํ๋ด๋ฉฐ, ์ผ์น ์ ์ ๋กํด ์ง์ ์ฐธ์กฐ URL์ด ํฌํจ๋ ์ ์์ต๋๋ค.
์ฐธ๊ณ : ๋ ์ง(์ถ์์ผ ๋๋ ๋ฐ๊ธ์ผ)๋ dd/mm/yyyy ํ์์ด์ด์ผ ํฉ๋๋ค.
ํค๋(Headers)โ
| ์ด๋ฆ | ๊ฐ |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์(Parameters)โ
info
์ง์๋๋ ๋ฌธ์ ์ข ๋ฅ์ ์ ์ฒด ๋ชฉ๋ก๊ณผ ๊ฐ ์ข ๋ฅ๋ณ ํ์ ๋งค๊ฐ๋ณ์๋ Document Types ๊ฐ์ด๋๋ฅผ ์ฐธ๊ณ ํด ์ฃผ์ธ์.
| ์ด๋ฆ | ํ์ | ํ์ | ์ค๋ช |
|---|---|---|---|
documentType | string | ์๋์ค | ์กฐํํ ๋ฌธ์ ์ข ๋ฅ. |
documentNumber | string | ์๋์ค | ์กฐํํ ๋ฌธ์ ๋ฒํธ. ๊ณต๋ฐฑ์ด๋ ์ ์์ด ์ ๋ ฅํฉ๋๋ค. |
fullName | string | ์๋์ค | documentType๊ณผ documentNumber ๋์ ๊ฐ์ธ ๋๋ ๋ฒ์ธ์ ์ด๋ฆ์ ์ง์ ์ ๋ฌํ ์ ์์ต๋๋ค. |
ํ์ฉ ์ฌ๋กโ
- ์ฌ๊ธฐ ์๋ฐฉ: ๋ฏผ๊ฐํ ๊ฑฐ๋ ์ด์ ์ ์ ๋กํด ํ์ฌ ๋ฐ์ดํฐ๋ฒ ์ด์ค์ ๋ฑ์ฌ๋ ์ธ๋ฌผ์ ์๋ณํฉ๋๋ค.
- ์ ์ ๊ฒ์ฆ: ์ ๊ณต๋ ๊ฐ์ธ์ ๋ณด์ ์ ํฉ์ฑ์ ํ์ธํฉ๋๋ค.
- ์ปดํ๋ผ์ด์ธ์ค: ์ํ, ๊ธ์ต, ๋ถ๋์ฐ ๋ถ์ผ์ KYC ๋ฐ AML ์ ๊ฒ์ ์ง์ํฉ๋๋ค.
์์ฒญ(Request)โ
- JavaScript
- Python
- PHP
- Swift
import axios from "axios";
const options = {
method: "GET",
url: "https://api.verifik.co/v2/europol",
params: { documentType: "CC", documentNumber: "80251972" },
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/europol?fullName=Mateo%20Verifik", 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/europol?fullName=Mateo Verifik', [
'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/europol?fullName=Mateo%20Verifik")! 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()
์๋ต(Response)โ
- 200
- 404
{
"data": {
"documentType": "CC",
"documentNumber": "123456789",
"fullName": "MATEO VERIFIK",
"firstName": "MATEO",
"lastName": "VERIFIK",
"arrayName": ["MATEO", "VERIFIK"],
"foundInEuropol": true,
"urlEuropol": "https://eumostwanted.eu/es#/es/node/162"
},
"signature": {
"dateTime": "June 28, 2022 12:40 PM",
"message": "Certified by Verifik.co"
}
}
{
"code": "NotFound",
"message": "Record not found."
}
๋น๊ณ โ
- ์ ๋กํด ๋ฐ์ดํฐ๋ฒ ์ด์ค ์กฐํ: ๋ฌธ์ ๊ธฐ๋ฐ ๋๋ ์ด๋ฆ ๊ธฐ๋ฐ ์กฐํ๋ฅผ ์ง์ํฉ๋๋ค.
- ๋งค์น ๊ฐ์ง: ํด๋น ์ ์ ๋กํด ์ง์ URL์ด ์๋ต์ ํฌํจ๋ ์ ์์ต๋๋ค.
- ๊ตฌ์กฐํ๋ ์๋ต: ํตํฉ์ ์ ํฉํ ํ์์ผ๋ก ๋ฐ์ดํฐ๋ฅผ ๋ฐํํ๋ฉฐ, ์์์ JavaScript, Python, PHP, Swift ์์ ๋ฅผ ์ ๊ณตํฉ๋๋ค.