ImageBucket API
The ImageBucket API allows you to fetch information about users and images.
All API calls should be made to https://img.zrmiller.com/api/{endpoint}
.
GET
/users
Returns an array of all user.
Response
username
String
The user's ImageBucket username.timeJoined
String
The datetime of when the user signed up. Format is 'Year-Month-Day Hour:Minute:Second'.url
String
The URL for the user's profile, which will display all images uploaded by the user.Example Response
[ { "username": "CatFan42", "timeJoined": "2023-05-30 17:07:17", "url": "https://img.zrmiller.com/u/CatFan42" }, { "username": "nature_is_neat", "timeJoined": "2023-05-30 18:06:13", "url": "https://img.zrmiller.com/u/nature_is_neat" } ]
GET
/users/{username}
Returns data about a single user.
Parameters
username
String
The username of the target user.Response
username
String
The user's ImageBucket username.timeJoined
String
The datetime of when the user signed up. Format is 'Year-Month-Day Hour:Minute:Second'.url
String
The URL for the user's profile, which will display all images uploaded by the user.Example Response
{ "username": "CatFan42", "timeJoined": "2023-05-30 17:07:17", "url": "https://img.zrmiller.com/u/CatFan42" }
GET
/users/{username}/images
Returns an array of all images uploaded by the target user.
Parameters
username
String
The username of the target user.Response
author
String
The username of the person who uploaded the image.uuid
String
The unique ID of the image.extension
String
The file type extension for the image.thumbnail
Boolean
Returns true if this image has had a thumbnail version created.animated
Boolean
Returns true if this image is a gif with more than one frame.timeUploaded
String
The datetime when the image was uploaded. Format is 'Year-Month-Day Hour:Minute:Second'url
String
A direct to the target image.thumbnailURL
String
A direct to the target image's thumbnail. If the image has no thumbnail, the full sized image will be served instead.Example Response
[ { "author": "CatFan42", "uuid": "qvVzecRX", "extension": "jpg", "thumbnail": true, "animated": false, "timeUploaded": "2023-05-30 17:51:24", "url": "https://img.zrmiller.com/i/qvVzecRX.jpg", "thumbnailURL": "https://img.zrmiller.com/i/qvVzecRX_thumbnail.jpg" }, { "author": "CatFan42", "uuid": "JxVcaRsz", "extension": "jpg", "thumbnail": true, "animated": false, "timeUploaded": "2023-05-30 17:51:30", "url": "https://img.zrmiller.com/i/JxVcaRsz.jpg", "thumbnailURL": "https://img.zrmiller.com/i/JxVcaRsz_thumbnail.jpg" } ]
GET
/images
Returns an array of all uploaded images.
Response
author
String
The username of the person who uploaded the image.uuid
String
The unique identifier of the image.extension
String
The file type extension for the image.url
String
A direct link to the target image.Example Response
[ { "author": "CatFan42", "uuid": "qvVzecRX", "extension": "jpg", "url": "https://img.zrmiller.com/i/qvVzecRX.jpg" }, { "author": "CatFan42", "uuid": "JxVcaRsz", "extension": "jpg", "url": "https://img.zrmiller.com/i/JxVcaRsz.jpg" } ]
GET
/images/{uuid}
Returns metadata for a single image.
Parameters
uuid
String
The unique identifier of the target image.Response
author
String
The username of the person who uploaded the image.uuid
String
The unique ID of the image.extension
String
The file type extension for the image.thumbnail
Boolean
Returns true if this image has had a thumbnail version created.animated
Boolean
Returns true if this image is a gif with more than one frame.timeUploaded
String
The datetime when the image was uploaded. Format is 'Year-Month-Day Hour:Minute:Second'url
String
A direct to the target image.thumbnailURL
String
A direct to the target image's thumbnail. If the image has no thumbnail, the full sized image will be served instead.Example Response
{ "author": "CatFan42", "uuid": "qvVzecRX", "extension": "jpg", "thumbnail": true, "animated": false, "timeUploaded": "2023-05-30 17:51:24", "url": "https://img.zrmiller.com/i/qvVzecRX.jpg", "thumbnailURL": "https://img.zrmiller.com/i/qvVzecRX_thumbnail.jpg" }