Nəqliyyat vasitələrin tarix hesabatları aparıcı təchizatçıların üzrə vahid qiymətə.
We are glad to provide developers with our simple API which you can use in your projects absolutely for free.
Our API supports white-label which means you may resell reports under your own brand.
PRICING (QTY - PRICE PER REPORT)
1 to 49 hesabat - 8.50 AZN ($5)
50 to 99 hesabat - 7.65 AZN ($4.5)
100 to 499 hesabat - 6.80 AZN ($4)
500 to 999 hesabat - 5.95 AZN ($3.5)
1000-den artiq - 5.10 AZN ($3)
YENİLƏNİB @ 25.09.2023 - XÜSUSIYYƏTLƏRİ ENDPOİNTLƏR ƏLAVƏ EDİLMİŞDİR
Spesifikasiyalar hesabatı üçün - $0.10.
TOPDAN SİFARİŞLƏRİNİZ ÜÇÜN XÜSUSİ QİYMƏT ALMAQ İSTƏSİNİZSƏ, BİZƏ MESAJ YAZIN!
HAZIRDA DİGƏR PROVİDERLƏRƏ ÖDƏDİYİNİZDƏN DAHA YAXŞI QİYMƏT SİZƏ TƏKLİF EDƏCƏYİK!
HAZIRDA DİGƏR PROVİDERLƏRƏ ÖDƏDİYİNİZDƏN DAHA YAXŞI QİYMƏT SİZƏ TƏKLİF EDƏCƏYİK!
***********************
REGISTER API ACCOUNT
Request: https://vini.az/en/api/register?email={YOUR_EMAIL}&name={YOUR_NAME}
Example response: {"status":true/false, "key": "b0d8c6e5ea589e6fc3d3e08afb1873bb"}
Key in response is your private API key for all further requests.
***********************
BALANCE CHECK
Request: https://vini.az/en/api/balance?key={API_KEY}
Response: {"balance":"0.00"}
***********************
BALANCE REPLENISH
Request: https://vini.az/en/api/replenish?key={API_KEY}&amount={0.00}
Response: You will be redirected to our bank's payment page and after submitting payment form you'll get back to API which will return JSON of payment result.
Example response: {"status":true/false,"amount":"100","transaction_id":"OMV5TXAL1Z7S2VMK"}
Note: If status=true, this means the payment was successful, otherwise payment is failed.
Billing Currency
The payment is done in AZN so please make sure to convert desired amount into this currency before proceeding.
Current rate is $1 = ~1.7 AZN, for example: $5.88 = 10 AZN
You may use free currency convertor: https://xe.com)
***********************
CHECK REPORT AVAILABILITY
Request: https://vini.az/en/api/check?key={API_KEY}&vin={VIN_NUMBER}&type={REPORT_TYPE}
Response: {"status":true/false, "extra": {"count": 123}}
VIN: must be a 17 chars long alpha-numeric
Report types available: carfax, autocheck, copart
Note: If the status=true, this means report is available and you can request it
Note: "extra" holds additional data, like the count of records available for requested VIN in specified provider.
***********************
GENERATE REPORT
Request: https://vini.az/en/api/report?key={API_KEY}&vin={VIN_NUMBER}&type={REPORT_TYPE}
Response: report in HTML format or JSON with error
VIN: must be a 17 chars long alpha-numeric
Report types available: carfax, autocheck, copart
Note: If you've got a JSON in response, this means there was an error with your request, otherwise your balance will be deducted.
Note: Multiple same requests doesn't affect your balance, only the first unique request will affect it.
*****************
SPECIFICATIONS REPORT - PAID
Request: https://vini.az/en/api/specs?key={API_KEY}&vin={VIN_NUMBER}&type=specs
Response: {"status":true/false, "data": {
'attributes': Array,
'equipments': Array,
'warranties': Array,
'colors': Array,
'recalls': Array,
}}
SPECIFICATIONS REPORT - FREE
Bu endpoint-ə edilən sorğular pulsuzdur, lakin sizin balansınızda ən azı 1 hesabatın qiyməti olmağı tələb olunur.
Bu endpoint-ə edilən sorğular pulsuzdur, lakin sizin balansınızda ən azı 1 hesabatın qiyməti olmağı tələb olunur.
Request: https://vini.az/en/api/specs_simple?key={API_KEY}&vin={VIN_NUMBER}&type=specs
Response: {"status":true/false, "data": {
'make': String,
'manufacturer_name': String,
'model': String,
'model_year': Int,
'series': String,
'vehicle_type': String,
'plant_country': String,
'plant_company_name': String,
'body_class': String,
'doors': String,
'drive_type': String,
'fuel_type_primary': String,
}}
*****************
TEST DATA
You may use VIN 12345678901234567 as for the development purposes.
In this case your balance will not be affected and you will bypass some API security filters.
***********************
WHITE-LABEL STATIC ASSETS
All links to static content in some reports are hardcoded to Vini.az, but you may replace them with your own URL.
In this case you'll need to download archive with static assets to your own server and replace all "https://vini.az" links.
Download static assets: https://vini.az/carfax.zip