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/COUNTRY_CODE/image | |
|---|---|---|
| Method | GET | |
| Access level | PERSONAL, VIEWER, MANAGER, OWNER, RESELLER, RESELLER_ADMIN, ADMIN | |
| Params | COUNTRY_CODE | 2-Char ISO3166 country code of the destination |
Request example
https://api.telecomx.dk/destination/DE/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 | None - destination images are served publicly by image id. | |
| Params | IMAGE_ID | Id of the image to show (the destination's image 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 | [Optional] If format is jpeg, this sets the image quality 1-100. |
|
Errors
| Error code | Message | Description |
|---|---|---|
| 422 | id | Country code is not valid |
| 404 | id | Destination not found, or the destination has no image |
| 404 | not_found | The image could not be fetched from the image service |
| 403 | access_denied | Insufficient access level |
| 500 | internal_error | <Unspecified> |
api/destination/image-download.txt · Last modified: by Mikkel Meerwaldt Jørgensen