Car database REST API Car2Db.com
Car database REST API Car2Db.com
In order to use some API Car2DB method, you should send GET-query via HTTPS to the following URL.
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;
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.
