User Tools

Site Tools


api:destination:image-download

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

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki