image.adoc

Image Service API

Service Description

Image Service API allows uploading of product images to be stored and used within the iZettle applications. The service returns a imageLookupKey that can be added to a desired product using the Product Library API. The images can be uploaded using a byte array or a static URL, the image will be eventually available for lookup from within the iZettle apps or via the imageUrls returned by the service (See Swagger documentation for upload restrictions).

NOTE: JPG does not exist as an imageFormat, you must use JPEG for .jpg images

URL

https://image.izettle.com/v2/images

API Documentation

https://image.izettle.com/swagger

---

Example Request

POST https://image.izettle.com/v2/images/organizations/{organizationUuid}/products

{
  "imageFormat": "JPEG",
  "imageData": null,
  "imageUrl": "https://example.com/image.jpg"
}

Example Response

{
  "imageLookupKey": "0SFqIEwSEeWQb_kt6ixqNQ-10TukFTMEaekExOP02bdsw.jpeg",
  "imageUrls": [
    "https://image.izettle.com/productimage/o/0SFqIEwSEeWQb_kt6ixqNQ-10TukFTMEaekExOP02bdsw.jpeg",
    "https://image.izettle.com/productimage/L/0SFqIEwSEeWQb_kt6ixqNQ-10TukFTMEaekExOP02bdsw.jpeg"
  ]
}

Where o is a 2000*2000px and L is a 560*560px image.

A test environment will be made available soon, in the mean time integrators with production credentials can try out the API by creating their own iZettle account.