A Detail URL contains all details of a vehicle.
For example , we create a URL http://www.yourdomain.com/url-to-car-detail.html?id=1 to response a JSON content as below:
{
errorCode: 0,
message: "",
data: {
id: "100110",
condition: "Used",
vehicleType: "Car",
postTime: "2023-11-05T09:09:45Z",
lastModify: "2023-11-05T09:09:45Z",
make: "Mercedes Benz",
model: "C-Class",
subModel: "C320",
modelDetails: "",
price: "160000",
year: "2022",
transmission: "Automatic",
mileage: "75000",
exteriorColor: "Blue",
engine: "2488",
fuelType: "Petrol",
status: "Active",
description: "This car is in good condition.
* One Careful Owner
* New Facelift Model
* 3.2L Diesel Turbocharged Engine
* 200 Horsepower & 470 Nm
* 6 Speed Auto Transmission
* 2-Tune Leather Seat
* Multi Function Steering
* Auto Cruise Function
* Reverse Camera
* 4 Wheels Function 4X4
",
photos: [
"http://www.yourdomain.com/static/sitemap/1.jpg",
"http://www.yourdomain.com/static/sitemap/2.jpg",
"http://www.yourdomain.com/static/sitemap/3.jpg",
"http://www.yourdomain.com/static/sitemap/4.jpg"
],
coverPhoto: "http://www.yourdomain.com/static/sitemap/1.jpg",
interiorColor: "White",
sellerName: "Tom",
phone: "880123400",
whatsApp: "880123400",
location: "Your location info here"
}
JSON Key Descriptions:
Name | Type | Required | Description |
errorCode | Int | Required | Set to 0 means no errors , other Int value means error |
message | String | Optional | If some errors occurred, you can set an error message to this value. |
data | Object | Required | The data Object describe the details of this vehicle |
data.id | String | Required | A unique ID of this advert on your site.We update each Advert's Price,Mileage,Status or other details via this ID. You should promise each Advert has its own unique ID.Such as : 1234 , ba15c |
data.condition | String | Required | The condition of this vehicle.Only can set as : Used , New |
data.vehicleType | String | Required | The type of this vehicle.Only can set as : Car , Bike |
data.postTime | UTC Time | Required | The time of first post. The time should be UTC Time format.Such as 2023-10-12T09:07:29Z |
data.lastModify | UTC Time | Required | The time of last modified. The time should be UTC Time format.Such as 2023-10-12T09:07:29Z When we found this value has been changed , we'll try to update this advert in our database. |
data.make | String | Required | The brand of this vehicle.Only accept English words.Such as Audi , BMW, Mercedes Benz , Aston Martin , Land Rover , Rolls RoyceWe DO NOT allow '-' in a brand name , use a ' ' (space) instead of. |
data.model | String | Required | The Model of this vehicle.Only accept English words.Such as A6 , Camry, Jazz , 5 Series |
data.subModel | String | Optional | The Sub-Model of this vehicle.This only provided when the current brand has series models , like BWM , Mercedes Benz.Value such as : 525i , when the brand is BWM and model is 5 SeriesValue such as : C230 , when the brand is Mercedes Benz and model is C-Class Please Don't worry about the Models' values, our system can fix the problems when your model is not match ours. |
data.modelDetails | String | Optional | More descriptions on model.Accept descriptions from any languageSuch as : Long Range , M Sport , 美版 |
data.price | Number | Required | The Price of this vehicle.Only accept number type |
data.transmission | String | Required | The transmission of this vehicle.Only can set as : Automatic , Manual , Other |
data.mileage | Number | Required | The mileage of this vehicle. Unit: Km.Only accept number type |
data.exteriorColor | String | Required | The exterior color of this vehicle.Accept any color words from any languageSuch as : Blue , White , 藍色 , Màu đen , สีน้ำเงิน |
data.engine | Number | Required | The Engine Capacity of this vehicle. Unit: cc.Only accept number type |
data.fuelType | String | Required | The Fuel Type of this vehicle.Only can set as : Petrol , Diesel , Electric , Hybrid , Other |
data.status | String | Required | The status of this advert. You can change this value for displaying or not on our site.Only can set as : Active , Sold , Pending , Removed Active : This advert will display on our site and status is On Sale.Sold,Pending,Removed : This advert will NOT display on our site.Removed : We will delete this advert in 90 days.You also can manage the adverts on your user panel. |
data.description | String | Required | The descriptions of this advert.We DO NOT allow HTML codes in this value. |
data.photos | Array | Required | The photos of this vehicle.Each element is the photo URL and should start with http:// or https:// |
data.coverPhoto | String | Optional | The Cover photo of this vehicle , it will display on search results page or other pages.If not set , we will use the first element of data.photosIf set , it should start with http:// or https:// |
data.interiorColor | String | Optional | The interior color of this vehicleAccept any color words from any languageThe setting is same as data.exteriorColor |
data.sellerName | String | Optional | The contact name or seller name of this advert.If not set , we'll use your account's seller name. |
data.phone | String | Optional | The contact phone of this advert.If not set , we'll use your account's phone. |
data.whatsApp | String | Optional | The whatsApp account of this advert.If not set , we'll use your account's whatsApp. |
data.location | String | Optional | The location of this advert.If not set , we'll use your account's location. |