Unify and manage your data

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.
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"
}