HEhere
metadata

Gets a list of available catalog versions that respect the given dependencies

Given a list of HRNs and versions provided by the user, returns a list of versions of this catalog for which the listed HRN are either present in the direct or indirect dependencies with the same version, or are not present. Depending on 'strict' flag versions that don't depend on any of the provided catalog HRNs, can also be considered compatible. The compatible versions are returned in reverse order, from the newest to the oldest. When there is no compatible version the service returns an empty list. When the catalog has no version a 404 is returned.

post/versions/compatibles

Request

  • Base URL
    https://use.apilookup.for.a.base.url
  • URL
    https://use.apilookup.for.a.base.url/versions/compatibles
  • Auth
    HTTP bearer

Query parameters

limitinteger

The numbers of items to return per page

strictboolean

if 'strict=true' versions to be considered compatible should depend on at least one of the provided catalog HRNs.

Request body

Example request

{
  "dependencies": [
    {
      "hrn": "hrn:here:data:::my-catalog",
      "version": 24
    }
  ]
}

Response

OK

nextstring uri

If the number of results exceeds the provided limit then this uri will be present and will provide the path to the next batch of results.

Example response

{
  "versions": [
    {
      "version": 42,
      "sharedDependencies": [
        {
          "hrn": "hrn:here:data:::my-catalog",
          "version": 24
        }
      ]
    }
  ],
  "next": "/uri/to/next/page"
}

Changes

No recorded changes to this operation across all 1 revision of this API.