Unify and manage your data

Upload Image (Version)

Request:

POST {ImageHostingURL}/image/{environmentId}/{tenantId} 
Table 1. Parameters
ParametersNameRequiredDetails
HeadersAuthorizationYesInformation about the authentication access token in the format Bearer <accessToken> (see details in Authentication API ).
QueryenvironmentIdYesEnvironment identifier which builds the URL as https://{environmentId}.reltio.com.
tenantIdYesTenant identifier.
BodyYesContent-type should be multipart/form-data.
fileNoImage to upload. Type should be application/octet-stream.
sourceURLNoURL of source image.
uploadNoIf 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 {your-access-token}
Content-Type: multipart/form-data

Upload the image file:

POST {ImageHostingURL}/image/myEnvironment/myTenant
{
  "file" : binary file
}
Headers
Authorization: Bearer {your-access-token}
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 CauseStatus CodeError Code
Authorization token is not valid.40142001
File format is not supported.41542002
File size exceeds configured maximum file size.40042003
Illegal request parameters.40042004
Internal service error.50042005

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