Services for car shops

Database API Documentation

Introduction to Tyres and Database API

API has RESTfull interface, you should have API key for requests. API key you can generate after purchase, on database page.

Actual API version: 1

URL endpoints

All requests should pass to this endpoints:
http://tyresaddict.ru/api/... - for common requests
http://tyresaddict.ru/api/supplier/... - for requests to Shop Integration service
http://tyresaddict.ru/api/tyres/... - for requests to Tyres API

API separated by services and databases for versioning and separation by products. Currently, this is
supplier - API for use Shop Intergation service, API will work for any clients of databases
tyres - key type and Tyre API (will work for clients of Tyre Database and clients of Database Pack)
uni - key type for database pack, for all APIs

Required parameters

For all calls excluding /info you should use two required params: api_version - API version on client-side (we'll try to support old versions too) api_key - API key

Returned data

API always return JSON. It has result field - true\false, and if result is false, JSON will have message foeld with description of problem

API Documentation formats

We have several formats of documentation, all links you can find here:

Site docs (here)
Tyre API Documentation Wheel Fitment API Documentation

OpenAPI/Swagger Documentation (beta!)
Tyre API Documentation / OpenAPI / Swagger Wheel Fitment API Documentation / OpenAPI / Swagger

Common requests

GET /[supplier|tyres|fitment]/info - get common info, versions, key if key is passed to method parameters method can call without required parameters. but if it calls with API key, then return key info
test from this page answer api_type - API type api_version - API version on server

{"result":true,"api_type":"tyres","api_version":1}

GET /[supplier|tyres|fitment]/updates - get db update dates parameters no answer

{"db_tyres":"2020-01-27","db_wheels":"2020-01-18","db_vehicle":"2020-01-27","result":true}

Shop Integration Service API

POST /supplier/process_csv - process supplier csv (see site service)
parameters csv - price csv in service format (see service documentation) answer csv - csv result, in service format (see service documentation) offers_count - count of processed offers in price csv found_offers_count - count of offers, found and have connected id from our databases

{"result":true,"csv":"1313;8;880;Kumho;Ice Power KW21\nT354;17;494;Hankook;Radial DW04\n","offers_count":12,"found_offers_count":10}

POST /supplier/process_csv_utf8 - process supplier csv (see site service), use UTF-8 ONLY: for parameters and for output
parameters csv - price csv in service format (see service documentation) answer csv - csv result, in service format (see service documentation) offers_count - count of processed offers in price csv found_offers_count - count of offers, found and have connected id from our databases

{"result":true,"csv":"1313;8;880;Kumho;Ice Power KW21\nT354;17;494;Hankook;Radial DW04\n","offers_count":12,"found_offers_count":10}

Tyres Database API

GET /tyres/vendors - get full list of tyre vendors parameters no answer

{"result":true,"vendors":[{"vendor_id":"13","vendor_name":"Accelera","vendor_url":"accelera"},{"vendor_id":"56",...

GET /tyres/find_vendor_by_name - find tyre vendor by name parameters vendor_name - tyre vendor name answer

{"result":true,"vendor":{"vendor_id":"1","vendor_name":"Michelin","vendor_url":"michelin"}}

V1GET /tyres/find_vendor_by_id
V1,V2 GET /tyres/vendor - tyre vendor information by vendor_id parameters vendor_id - tyre vendor id answer

{"result":true,"vendor":{"vendor_id":"1","vendor_name":"Michelin","vendor_url":"michelin"}}

GET /tyres/vendor_models - get full list of vendor tyre models parameters vendor_id - tyre vendor id answer

{"result":true,"models":[{"model_id":"1252","model_name":"4x4 A/T XTT","model_url":"4x4_at_xtt","auto_id":"2","season_id":"3"},{"model_id":"240",

GET /tyres/model - tyre information by model_id parameters model_id - tyre model id answer Important non-db fields:
photo_catalog - (beta) catalog photo (square 180x180px) sample, path for local db storage
cdn_photo_catalog - (beta) catalog photo (square 180x180px) sample, from our cdn. write us if you plan to use it

{"result":true,"model":{"model_id":"123","model_name":"Pilot Exalto","model_url":"pilot_exalto","model_year":"2009","car_type":"1","car_type_str":"passenger","season":"summer",...

GET /tyres/model_specs - tyre size and spec information by model_id parameters model_id - tyre model id answer

{"result":true,"sizes":{"sizes":[{"width":"205","profile":"55","rim":"16","load_index":"91","speed_rating":"Y","runflat_flag":"off","xl_flag":"off","c_flag":"off"},{"width":"195","profile":"50",...

Tyre and Wheel Fitment API

In process, write us for speed up

GET /fitment/makes - Returns a list of manufacturers parameters exclude_local - (optional) 'true' for get list without local country makes answer

{"result":true,"makes":[{"make_id":"22","make_name":"Acura","make_url":"acura"},{"make_id...

GET /fitment/make - Returns manufacturer info by make_id parameters make_id - make_id of manufacturer answer

{"result":true,"make":{"make_id":"1","make_name":"Alfa Romeo","make_url":"alfa_romeo"}}

GET /fitment/series - Returns car series by make_id parameters make_id - make_id of manufacturer answer

{"result":true,"series":[{"model_seria":"CL"},{"model_seria":"EL"},{"model_seria":"ILX"},{"model_seria...

GET /fitment/models - Returns car models by make_id parameters make_id - make_id of manufacturer answer

{"result":true,"models":[{"model_id":"18","model_seria":"CL","model_name":"CL","model_url":"cl","model_start_year":"1998","model_end_year":"2001"},{"model_id":"1589","model_seri...

GET /fitment/model_years - Returns car model production years by model_id parameters model_id - model_id of car model answer

{"result":true,"years":[1998,1999,2000,2001]}

GET /fitment/model_modifications - Returns car model modifications by model_id and year parameters model_id - model_id of car model year - year of production answer

{"result":true,"years":[{"mod_id":"6","mod_name":"2.3 i"},{"mod_id":"7","mod_name":"3.0 i"}]}

GET /fitment/fitment - Returns wheel fitment data by model_id, year and mod_id parameters model_id - model_id of car model year - year of production mod_id - mod_id of modification answer

{"result":true,"fitment":{"wheel_params":{"param_id":"5","dia":"67.1","nut":"12x1.5","bolt":"0x0","pcd":"4x114.3","pcd_first":"4","pcd_second":"114.3"},"wheels":{"factory":...

GET /fitment/finder_specs - Returns wheel/tyre specs for finder parameters no answer width, r (diameter), bolt patetrns (wheel pcd), dia (center diameter of wheel)

{"result":true, "width":["3.5","4","4.5","5","5.5","6","6.5","7","7.5","8","8.5","9","9.5","10","10.5","11","11.5"],"r":["12","13",...