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
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 dataAPI 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
GET /[supplier|tyres|fitment]/updates - get db update dates parameters no answer
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
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
Tyres Database API
GET /tyres/vendors - get full list of tyre vendors parameters no answer
GET /tyres/find_vendor_by_name - find tyre vendor by name parameters vendor_name - tyre vendor name answer
V1GET /tyres/find_vendor_by_id
V1,V2 GET /tyres/vendor
- tyre vendor information by vendor_id
parameters
vendor_id - tyre vendor id answer
GET /tyres/vendor_models - get full list of vendor tyre models parameters vendor_id - tyre vendor id answer
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
GET /tyres/model_specs - tyre size and spec information by model_id parameters model_id - tyre model id answer
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
GET /fitment/make - Returns manufacturer info by make_id parameters make_id - make_id of manufacturer answer
GET /fitment/series - Returns car series by make_id parameters make_id - make_id of manufacturer answer
GET /fitment/models - Returns car models by make_id parameters make_id - make_id of manufacturer answer
GET /fitment/model_years - Returns car model production years by model_id parameters model_id - model_id of car model answer
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
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
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)