Image API refers to an interface that allows for the integration and retrieval of images related to hotels, accommodations, or other related visual content.
In other words, Image API allows you to upload, manage, and organize photos of your property. This increases the visibility of what your properties have to offer and might help with conversion.
An Image API could be used for the following purposes:
Create or provide images to display with a particular hotel, property, or room.
Retrieve images associated with a particular hotel, property, or room.
Dynamically update visual content, ensuring that images on various platforms remain accurate and current.
Integration with booking platforms and reservation systems allows for the seamless display of images.
Enhance the user experience for potential guests.
Maintain consistency in visual content across different online channels.
The Create Image API allows users to upload or create images in the PMS.
POST
hotelid string (Required)
Hotel id for which you want to create and image.
proppmsid string (Required)
Id assigned to a specific property within the PMS.
images string (Required)
url string (Required)
URL of the image.
name string (Required)
Name of the image.
pms_imageid string (Optional)
Id assigned to a specific image within the PMS.
https://connect-sandbox.su-api.com/SUAPI/jservice/imageCreate{
"hotelid": "P103",
"images": [
{
"url": "https://www.xxxxxxx.com/xxxx/roadblue/xxxx.jpg
",
"name": "road blue",
"pms_imageid": "2222"
},
{
"url": "https://www.xxxxxxx.com/xxxx/bsky/xxxx.jpg
",
"name": "b sky",
"pms_imageid": "1111"
},
{
"url": "https://www.xxxxxxx.com/xxxx/bsky/xxxx.jpg
",
"name": "b sky",
"pms_imageid": "1111"
},
{
"url": "https://www.xxxxxxx.com/xxxx/bsky/xxxx.jpg
",
"name": "b sky",
"pms_imageid": "1111"
},
{
"url": "https://www.xxxxxxx.com/xxxx/bsky/xxxx.jpg
",
"name": "b sky",
"pms_imageid": "1111"
}
]
}{
"Status": "Success",
"Data": [
{
"pms_imageid": "2222",
"image_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg
",
"su_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg"
},
{
"pms_imageid": "1111",
"image_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg
",
"su_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg"
},
{
"pms_imageid": "1111",
"image_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg
",
"su_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg"
},
{
"pms_imageid": "1111",
"image_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg
",
"su_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg"
},
{
"pms_imageid": "1111",
"image_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg
",
"su_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg"
}
]
}{
"hotelid": "P103",
"images": [
{
"url": "https://www.xxxxxxx.com/xxxx/roadblue/xxxx.jpg
",
"name": "road blue"
},
{
"url": "https://www.xxxxxxx.com/xxxx/bsky/xxxx.jpg
",
"name": "b sky"
},
{
"url": "https://www.xxxxxxx.com/xxxx/bsky/xxxx.jpg
",
"name": "b sky"
},
{
"url": "https://www.xxxxxxx.com/xxxx/bsky/xxxx.jpg
",
"name": "b sky"
},
{
"url": "https://www.xxxxxxx.com/xxxx/bsky/xxxx.jpg
",
"name": "b sky"
}
]
}
{
"Status": "Success",
"Data": [
{
"imageid": 11006,
"image_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg
",
"su_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg"
},
{
"imageid": 11005,
"image_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg
",
"su_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg"
},
{
"imageid": 11005,
"image_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg
",
"su_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg"
},
{
"pms_imageid": "1111",
"image_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg
",
"su_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg"
},
{
"imageid": 11005,
"image_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg
",
"su_url": "https://www.xxxxxxx.com/xxxx/abc/xxxx.jpg"
}
]
}The Image Association API enables users to associate an image already stored in the PMS with a property within the PMS.
This API is used to associate or connect images with a specific property.
POST
hotelid string (Required)
Hotel id for which you want to associate an image.
imageid string (Required)
Id assigned to a specific image within the PMS.
pmsimageid string (Required)
Id assigned to a specific image within the PMS.
Request sample for the image associated with imageid for property:
Request sample for the image associate with imageid for room:
Request sample for the image associate with pms_imageid for property:
Request sample for the image associate with pms_imageid for room:
Sample Success Response
https://connect-sandbox.su-api.com/SUAPI/jservice/imageAssociation{
"hotelid":"111",
"images": [
{
"imageid": "100"
},
{
"imageid": "200"
},
{
"imageid": "111"
}
]
}
{
"hotelid":"111",
"roomid":"RM1"
"images": [
{
"imageid": "300"
},
{
"imageid": "122"
},
{
"imageid": "333"
}
]
}{
"hotelid":"111",
"images": [
{
"pms_imageid": "111wing"
},
{
"pms_imageid": "222"
},
{
"pms_imageid": "522"
}
]
}{
"hotelid":"111",
"roomid":"RM1",
"images": [
{
"pms_imageid": "666"
},
{
"pms_imageid": "968"
},
{
"pms_imageid": "266"
}
]
}{
"Status": "Success"
}{
"hotelid": "P103"
}{
"Status": "Success",
"Data": [
{
"image_name": "tesssst leaf",
"source_url": "https://www.xxxxxxx.com/xxxx/tesssstleaf/xxxx.jpg",
"su_url": "https://www.xxxxxxx.com/xxxx/tesssstleaf/xxxx.jpg",
"imageid": 10977,
"pms_imageid": "",
"is_associate": false
},
{
"image_name": "blue leaf",
"source_url": "https://png.pngtree.com/thumb_back/fh260/background/20230903/pngtree-teal-knit-background-free-download-as-png-jpg-b-w-or-image_13208667.jpg",
"su_url": "https://www.xxxxxxx.com/xxxx/blueleaf/xxxx.jpg",
"imageid": 10978,
"pms_imageid": "",
"is_associate": false
},
{
"image_name": "car",
"source_url": "https://www.xxxxxxx.com/xxxx/car/xxxx.jpg",
"su_url": "https://www.xxxxxxx.com/xxxx/car/xxxx.jpg",
"imageid": 10993,
"pms_imageid": "",
"is_associate": true
},
{
"image_name": "b sky",
"source_url": "https://www.xxxxxxx.com/xxxx/bsky/xxxx.jpg",
"su_url": "https://www.xxxxxxx.com/xxxx/bsky/xxxx.jpg",
"imageid": 11005,
"pms_imageid": "1111",
"is_associate": true
},
{
"image_name": "road blue",
"source_url": "https://www.xxxxxxx.com/xxxx/roadblue/xxxx.jpg
",
"su_url": "https://www.xxxxxxx.com/xxxx/roadblue/xxxx.jpg
",
"imageid": 11006,
"pms_imageid": "2222",
"is_associate": false
}
]
}