Wheel Fitment API Client SDK for Java
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.swagger-codegen
docs
gradle/wrapper
src
.gitignore
.swagger-codegen-ignore
.travis.yml
README.md
build.gradle
build.sbt
git_push.sh
gradle.properties
gradlew
gradlew.bat
pom.xml
settings.gradle

README.md

ws-api-client-java

Wheel Fitment API

  • API version: v1
    • Build date: 2018-04-17T19:52:20.875+06:00

The Wheel Fitment API allows for programmatic access to the database of www.wheel-size.com and its services. Use this API to retrieve information about vehicle fitment database for rims and tires, including OE and option fitments, and plus/minus sizing fitment information. A variety of country and language specific options are available. The coverage of fitment data for vehicles manufactured since 2000 is nearly 100%. The information about fitment data is updated on a daily basis.

Automatically generated by the Swagger Codegen

Requirements

Building the API client library requires:

  1. Java 1.7+
  2. Maven/Gradle

Installation

To install the API client library to your local Maven repository, simply execute:

mvn clean install

To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:

mvn clean deploy

Refer to the OSSRH Guide for more information.

Maven users

Add this dependency to your project's POM:

<dependency>
  <groupId>driveate</groupId>
  <artifactId>ws-api-client-java</artifactId>
  <version>1.0.0</version>
  <scope>compile</scope>
</dependency>

Gradle users

Add this dependency to your project's build file:

compile "driveate:ws-api-client-java:1.0.0"

Others

At first generate the JAR by executing:

mvn clean package

Then manually install the following JARs:

  • target/ws-api-client-java-1.0.0.jar
  • target/lib/*.jar

Getting Started

Please follow the installation instruction and execute the following Java code:

import com.wheelsize.api.client.*;
import com.wheelsize.api.client.auth.*;
import com.wheelsize.api.client.model.*;
import com.wheelsize.api.client.api.MakesApi;

import java.io.File;
import java.util.*;

public class MakesApiExample {

    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        
        // Configure API key authorization: user_key
        ApiKeyAuth user_key = (ApiKeyAuth) defaultClient.getAuthentication("user_key");
        user_key.setApiKey("YOUR API KEY");

        MakesApi apiInstance = new MakesApi();
        String countries = "us,gb,jp"; // String | Show information for local manufacturers from specified countries only. Use `GET /countries/` method to get the full list of countries. (e.g. `us,gb,jp`)
        try {
            List<Make> result = apiInstance.makesList(null, null, null, countries, null);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling MakesApi#makesList");
            e.printStackTrace();
        }
    }
}

Documentation for API Endpoints

All URIs are relative to https://api.wheel-size.com/v1

Class Method HTTP request Description
BoltPatternsApi boltPatternsList GET /bolt-patterns/ Get list of bolt patterns
BoltPatternsApi boltPatternsRead GET /bolt-patterns/{bolt_pattern}/ Model modifications by bolt pattern
CountriesApi countriesList GET /countries/ Returns a list of countries
GenerationsApi generationsList GET /generations/ Generations for the given model
MakesApi makesList GET /makes/ Returns a list of manufacturers
MarketsApi marketsList GET /markets/ Returns a list of markets/regions
ModelsApi modelsList GET /models/ Returns a list of models by manufacturer
ModelsApi modelsRead GET /models/{make}/{slug}/ Get more info about model
ModelsApi modelsReadYear GET /models/{make}/{slug}/{year}/ Get more info about model/year
SearchApi searchByHfTireList GET /search/by_hf_tire/ Find models matching given high flotation tire
SearchApi searchByModelList GET /search/by_model/ Find OE and option fitments by model/year/trim
SearchApi searchByRimList GET /search/by_rim/ Find models matching given rim parameters
SearchApi searchByTireList GET /search/by_tire/ Find models matching given tire parameters
TiresApi tiresList GET /tires/ Returns a list of tires
TiresApi tiresRead GET /tires/{tire}/ Model modifications matching given tire
TrimsApi trimsList GET /trims/ Model modifications
VehiclesApi vehiclesList GET /vehicles/ Find OE and option fitments by model/year/trim
YearsApi yearsList GET /years/ Returns list of years for the given manufacturer/model

Documentation for Models

Documentation for Authorization

Authentication schemes defined for the API:

user_key

  • Type: API key
  • API key parameter name: user_key
  • Location: URL query string

Recommendation

It's recommended to create an instance of ApiClient per thread in a multithreaded environment to avoid any potential issues.

Author

info@wheel-size.com