Car database REST API Car2Db.com
Car database REST API Car2Db.com
https://api.car2db.com/api/auto/v1/entityName.actionName.format.language?api_key=[api_key]&id_type=[id_type]
entityName — requested entity:
- type — vehicle type
- mark — manufacturer
- model
- series
- generation
- modification — modification
- characteristic
- characteristicValue
- equipment
- option
- optionValue
actionName — action:
- getAll — getting all entity instances;
- getDateUpdate — getting a date when the data was last refreshed;
format — the output data format:
- csv — only CSV is available yet for the getAll action (first row is a column title; comma separated values in quotes);
- timestamp — returns a Unix timestamp for the getDateUpdate action;
- string — returns a string formated as "F j, Y, g:i a" (March 10, 2017, 5:16 pm) for the getDateUpdate action;
language — database language:
- en — english;
- de — deutsche;
- pl — polish;
params — query parameters:
- api_key — API key (token), sent after a request for );
- id_type — vehicle type ID;
Request examples
You can see how the API works by sending requests from the user-friendly interface. For each function described the request parameters and the format of the returned data.
type
make
model
generation
serie
trim
specification
specificationValue
equipment
option
optionValue
Error codes
You should assume that errors may occur in the request result. It returns as error codes of the HTTP request.
401 — API key invalid or expired
Invalid API key or the validity of your key over. Please contact support at
404 — page not found
It is impossible to get the result for specified request parameters. Check id_type parameter, which is mandatory for all entities, except for the actual type.
500 — server error
Temporary disruption of service.
501 — requested method does not exist
Requested a non-existent action for the specified entity.
503 — data updating
Temporary discontinuance of service because of database updates.
509 — API requests limit
Exceeded the maximum number of calls to the API in the last 24 hours. Wait please.