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 Royce
We 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 Series
Value 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 language
Such 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 language
Such 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.photos
If set , it should start with http:// or https://
|
data.interiorColor |
String |
Optional |
The interior color of this vehicle
Accept any color words from any language
The 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.
|