Catalog Web Services Requirements Overview (Wheels)

Owned by Oleksandr Samarin
Last updated: Dec 08, 2023
4 min read

 

Catalog Web Services Requirements Overview

TireConnect supports wide range of industry standard protocols and connectivity methods.

Outlined below are general requirements which will provide TireConnect platform with the ability to receive list of wheels and it’s catalog data.

Dealer Authentication

All industry standard methods are supported and acceptable. 

Required Methods / Endpoints

List of brands

 Request structure

 Required

No

Optional

  1. offset

  2. limit

 Request example

GET https://somecatalogapi.com/api/catalog/wheels/brands

Response structure

 List of brands

  • name - Brand Name

  • id - Brand ID

  • logo - Brand Logo (optional, if present)

 Response example

{ "data": [ { "id": 1, "name": "Wheel Brand 1", "logo": "https://somecatalogapi.com/uploads/brand/a62696697df65760b3477bf4e025d81b6e409bc0.png" }, { "id": 2, "name": "Wheel Brand 2", "logo": "https://somecatalogapi.com/uploads/brand/a62696697df65760b1234bf4e025d81b6e503ac2.png" } ], "meta": { "count": 2, "total": 1000, "offset": 0, "limit": 100 } }

 

List of models

 Request structure

 Required

  • brand_id

Optional

  • offset

  • limit

 Request example

GET https://somecatalogapi.com/api/catalog/wheels/models?brand_id=1

Response structure

 List of models by requested brand

  • name - Model name

  • id - Model ID

  • brand_id - Brand ID

 Response example

 

List of wheels

 Request structure

 Required

  • brand_id

  • model_id

Optional, but preferred

  1. offset

  2. limit

 Request example

Response structure

 List of wheels by brand and model

  • brand_id - Brand ID

  • model_id - Model ID

  • upc - UPC

  • part_number - Part number

  • wheel_width - Width (inches)

  • wheel_diameter - Diameter (inches)

  • et - ET (Offset) (mm)

  • pcd_1 - array of pcd (mm)

  • bore_min - Minimum Centre Bore (mm) (optional, if present)

  • bore_max - Max Centre Bore (mm)

  • colour - Colour

  • min_wheel_load - Minimum Wheel Load (lbs) (optional, if present)

  • wheel_load - Wheel Load (lbs)

  • images - List of available Wheel images (angle type - required)

  • weight - Wheel Weight (lbs)

  • shipping_weight - Shipping Wheel Weight (lbs) (optional, if present)

  • material - Wheel Material

  • attributes - array of tire attributes, like winter_approved, electric_vehicle_optimized, etc. (optional, if present)

 Response example