Отчеты об истории транспортного средства от ведущих поставщиков по единой цене.
Мы рады предложить разработчикам наш простой и понятный API абсолютно бесплатно, который вы можете использовать в своих собственных проектах.
Наш API поддерживает "white-label", что означает, что вы можете продавать наши отчёты под своим брендом.
ЦЕНЫ (КОЛ-ВО - ЦЕНА ЗА ОТЧЁТ)
1 - 49 отчётов - 8.50 AZN ($5)
50 - 99 отчётов - 7.65 AZN ($4.5)
100 - 499 отчётов - 6.80 AZN ($4)
500 - 999 отчётов - 5.95 AZN ($3.5)
1000 и выше - 5.10 AZN ($3)
ОБНОВЛЕНИЕ @ 25.09.2023 - ДОБАВЛЕНЫ ТЕХНИЧЕСКИЕ ХАРАКТЕРИСТИКИ
0,10 доллара США за отчет о технических характеристиках.
ЕСЛИ ВАМ НЕОБХОДИМО СПЕЦАЛЬНОЕ ПРЕДЛОЖЕНИЕ ДЛЯ ВАШЕГО ЗАКАЗА, ПОЖАЛУЙСТА, НАПИШИТЕ НАМ!
МЫ ПРЕДЛОЖИМ ЛУЧШУЮ ЦЕНУ, ЧЕМ ТУ, ЧТО ВЫ ПЛАТИТЕ ДРУГОМУ ПОСТАВЩИКУ ОТЧЁТОВ!
МЫ ПРЕДЛОЖИМ ЛУЧШУЮ ЦЕНУ, ЧЕМ ТУ, ЧТО ВЫ ПЛАТИТЕ ДРУГОМУ ПОСТАВЩИКУ ОТЧЁТОВ!
***********************
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)
***********************
ПРОВЕРКА ДОСТУПНОСТИ ОТЧЁТА
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.
***********************
СОЗДАНИЕ ОТЧЁТА
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.
*****************
СПЕЦИФИКАЦИИ - ПЛАТНАЯ ВЕРСИЯ
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,
}}
СПЕЦИФИКАЦИИ - БЕСПЛАТНАЯ ВЕРСИЯ
Запросы к этой конечной точке бесплатны, но на вашем балансе должна быть хотя бы 1 цена отчета.
Запросы к этой конечной точке бесплатны, но на вашем балансе должна быть хотя бы 1 цена отчета.
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