๐ง๐ท ๋ธ๋ผ์ง โ ์ฐจ๋ ์ ๋ณด
์ฐจ๋ ์ ๋ณด ์กฐํโ
์๋ํฌ์ธํธโ
GET https://api.verifik.co/v2/br/vehicle
๋ธ๋ผ์ง ๋ฒํธํ์ด ์ฃผ์ด์ง๋ฉด Verifik๋ ๋จ์ผ ์์ฒญ์ผ๋ก ๊ตฌ์กฐํ๋ ์ฐจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ฐํํ์ฌ ์ค๋ฌผ ์์ฐ์ ๊ฒ์ฆยท์ ๊ทํ๋ ์์ฑ์ ์ฐ๊ฒฐํ ์ ์์ต๋๋ค. ์ฐจ๋ ์ด์ยท๋ชจ๋น๋ฆฌํฐ ์จ๋ณด๋ฉ, ๋ณดํ ๊ฒฌ์ ยท์ฌ๊ณ ์ฒ๋ฆฌ, ๋ด๋ณด ๋์ถยท๋ด๋ณด ์ฌ์ฌ, ๋ฒํธํ์ด ์ฃผ ์๋ณ์์ธ ๋ง์ผํ๋ ์ด์คยท๋๋ฌ ์ ๊ฒ ๋ฑ์ ๋์์ผ๋ก ํฉ๋๋ค.
Verifik API๋ ํด๋น ๋ฒํธํ์ ๋ํ ์ ๊ทํ๋ ์ฐจ๋ ๋ ์ฝ๋๋ฅผ ๋ฐํํฉ๋๋ค. ๋ฒํธํ, ์ ์กฐ์ฌ, ๋ชจ๋ธ, ๋ชจ๋ธ ์ฐ์ ๋ฐ ์ ์กฐ ์ฐ์, ์ฐจ๋(VIN), ์์ง, ์์, ์ฐจ์ฒด ์ ํ, ์ฐ๋ฃ, ๋ณ์๊ธฐ, ๋์ด ์, ์ ์กฐ์ฌ ๋๋ ๊ณต์ฅ, ์ฐจ๋์ ์ ์ฉ๋๋ ๊ฒฝ์ฐ FIPE ์ฝ๋, ํด๋น ๋ฑ๋ก์ ๋ถ์ดํ ๋๋ ์ ํ ์งํ๊ฐ ์์ผ๋ฉด ๊ทธ ์งํ ๋ฑ์ ํฌํจํฉ๋๋ค. ๊ณ์ ์งํํ๊ธฐ ์ ์ ์ค์ ์ฐจ๋์ด ๊ณต์ ์ ๋ณด์ ์ผ์นํ๋์ง ํ์ธํ๋ ๋ฐ ์ฌ์ฉํฉ๋๋ค.
ํค๋(Headers)โ
| ์ด๋ฆ | ๊ฐ |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์(Parameters)โ
| ์ด๋ฆ | ํ์ | ํ์ | ์ค๋ช |
|---|---|---|---|
plate | string | ์ | ์กฐํํ ๋ฒํธํ(์๋ฌธยท์ซ์; ๋์๋ฌธ์๋ ์ ๊ทํ๋จ). ์: ABC1D23. |
์์ฒญ(Request)โ
- JavaScript
- Python
- PHP
- Swift
import axios from "axios";
const options = {
method: "GET",
url: "https://api.verifik.co/v2/br/vehicle",
params: { plate: "ABC1D23" },
headers: {
Accept: "application/json",
Authorization: "Bearer <your_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 <your_token>",
}
conn.request("GET", "/v2/br/vehicle?plate=ABC1D23", "", headers)
res = conn.getresponse()
print(res.read().decode("utf-8"))
<?php
$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.verifik.co/v2/br/vehicle', [
'query' => ['plate' => 'ABC1D23'],
'headers' => [
'Accept' => 'application/json',
'Authorization' => 'Bearer <your_token>',
],
]);
echo $response->getBody();
var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/br/vehicle?plate=ABC1D23")!)
request.httpMethod = "GET"
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("Bearer <your_token>", forHTTPHeaderField: "Authorization")
let task = URLSession.shared.dataTask(with: request) { data, _, _ in
print(String(data: data ?? Data(), encoding: .utf8) ?? "")
}
task.resume()
์๋ต(Response)โ
- 200
- 404
- 409
- 500
{
"data": {
"bodyType": "Hatch",
"brand": "Example Brand",
"chassis": "9BWZZZ377VT004251",
"color": "PRATA",
"country": "Brasil",
"doors": "4",
"engine": "1.0",
"factory": "Example Plant",
"fuelType": "Flex",
"irregularitiesCount": "0",
"irregularityCode": "",
"manufacturer": "Example Manufacturer",
"model": "Example Model",
"modelYear": "2022",
"plate": "ABC1D23",
"transmission": "Manual",
"vehicle": "Automรณvel",
"version": "1.0 Flex",
"yearOfManufacture": "2022"
},
"signature": {
"dateTime": "April 20, 2026 12:00 PM",
"message": "Certified by Verifik.co"
}
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing plate\n"
}
{
"code": "InternalServerError",
"message": "Server error."
}
์ฐธ๊ณ โ
- ์ฟผ๋ฆฌ ๋ฌธ์์ด์์ ํ์์ธ ๊ฒ์
plate๋ฟ์ ๋๋ค. - ์ผ๋ถ ๊ณ์ ์์๋ ๋ฒํธํ๋ณ ํ์ฅ ๊ธฐ์ ์ํธ ์ ํ์ด ํ์ฑํ๋ฉ๋๋ค. ํด๋น ๊ธฐ๋ฅ์ด ์ผ์ ธ ์์ผ๋ฉด AppFeature ์นดํ๋ก๊ทธ์ ์๋ด๋ URL์ ์ฌ์ฉํ์ธ์.