Upload Image (Version)

Request:

POST {ImageHostingURL}/image/{environmentId}/{tenantId}

Table 1. Parameters
Parameters	Name	Required	Details
Headers	`Authorization`	Yes	Information about the authentication access token in the format Bearer <accessToken> (see details in Authentication API ).
Query	`environmentId`	Yes	Environment identifier which builds the URL as `https://{environmentId}.reltio.com`.
Query	`tenantId`	Yes	Tenant identifier.
Body		Yes	Content-type should be `multipart/form-data`.
	`file`	No	Image to upload. Type should be application/octet-stream.
	`sourceURL`	No	URL of source image.
	`upload`	No	If true the image should be uploaded to S3. This is taken into account only if `sourceUrl` is specified. Default value is true.

Upload the image file by a specified URL:

POST {ImageHostingURL}/image/myEnvironment/myTenant
{
  "sourceUrl" : “https://url.of.source.image”,
  "upload" : false
}

Headers

Authorization: Bearer {accessToken}
Content-Type: multipart/form-data

Upload the image file:

POST {ImageHostingURL}/image/myEnvironment/myTenant
{
  "file" : binary file
}

Headers

Authorization: Bearer 204938ca-2cf7-44b0-b11a-1b4c59984512
Content-Type: multipart/form-data

Body

{
  "Url": "https://full.size.url",
  "UrlPreview": "https://preview.url",
  "UrlThumbnail": "https://thumbnail.url",
  "CdnUrl": "https://cdn.full.size.url",
  "CdnUrlPreview": "https://cdn.preview.url",
  "CdnUrlThumbnail": "https://cdn.thumbnail.url",
  "Width": "800",
  "Height": "600",
  "Size": "4834",
  "MimeType": "image/png",
  "CreationTimestamp": "1465901311933"
}

Errors

Table 2. Possible Errors
Root Cause	Status Code	Error Code
Authorization token is not valid.	401	42001
File format is not supported.	415	42002
File size exceeds configured maximum file size.	400	42003
Illegal request parameters.	400	42004
Internal service error.	500	42005

Version

Get Full Version

GET {ImageHostingURL}/version

{
  "ih-server": {
    "hash": "31425e4b9be2989c3a8bf8adc2da36a2969fcf07",
    "branch": "master",
    "commitTime": "12.01.2017 @ 19:22:31 MSK",
    "release": "2017.1.0.0.0"
  }
}

Get Full Version for a Specific Component:

GET {ImageHostingURL}/version/ih-server

{
  "hash": "31425e4b9be2989c3a8bf8adc2da36a2969fcf07",
  "branch": "master",
  "commitTime": "12.01.2017 @ 19:22:31 MSK",
  "release": "2017.1.0.0.0"
}

Footer

You've found your way to a temporary environment. Content is not complete or final. Looking for Reltio documentation? Go to docs.reltio.com.

Unify and manage your data