api:destination:image-download
Table of Contents
API : Destination Download Image
Introduction
This request is used to download/get/show an image for the destination.
The picture is a PNG at 300×300 pixels.
Request
| URL | https://api.telecomx.dk/destination/DESTINATION_ID/image | |
|---|---|---|
| Method | GET | |
| Access level | PERSONAL, VIEWER, MANAGER, OWNER, RESELLER, RESELLER_ADMIN, ADMIN | |
| Params | DESTINATION_ID | Id of the destination to download the image for |
Request example
https://api.telecomx.dk/destination/1234567890ABCDEF1234578/image
Response
Binary image data: PNG at 300×300 pixels.
Example
N/A
Direct picture access
The picture can also be served directly from the image service like this:
| URL | https://image.telecomx.dk/<IMAGE_ID>.<FORMAT>?width=<width>&height=<height>&colors=<colors>&quality=<quality> | |
|---|---|---|
| Method | GET | |
| Access level | MANAGER or OWNER if user belongs to the customer of the employee. RESELLER if customer belongs to the reseller and employee belongs to the customer. ADMIN. |
|
| Params | PICTURE_ID | Id of the picture to show (not employee id) |
| FORMAT | Format to service picture in: png, jpeg | |
| width | [Optional] Width of picture, omit to use width of original image |
|
| height | [Optional] Height of picture, omit to use height of original image |
|
| colors | [Optional] If format is png, this set the max. number of colors to use 2-16Mill. |
|
| quality | [Optioanl] If format is jpeg, this sets the image quality 1-100. |
|
Errors
| Error code | Message | Description |
|---|---|---|
| 400 | bad_request | Id not found in request URI |
| 404 | not_found | Employee not found |
| 404 | picture | Picture not found |
| 500 | internal_error | File not found in database |
| 500 | internal_error | <unspecified> |
api/destination/image-download.txt · Last modified: 2023/10/30 21:18 by Per Møller