Skip to content

KNOWLEDGE BASE

Your Vercator® Software Questions, Answered.

Getting Started with Vercator API

The Vercator cloud registration service can be run completely headless by using the API. This allows users to build the Vercator engine into their own tools and services.

The Vercator Cloud API allows you to programmatically access and run the Vercator Cloud service without using the web portal. The easiest way to get started with the API is to visit its Swagger page which provides combined documentation as well as an API sandbox to do simple testing within the browser.

Overview

  1. You need a valid API Key to send requests to the API endpoints. You can get your key from the admin panel from the Vercator Cloud web portal.
    apiKey
  2. Generate key will create a new access key valid for 1 year. Please keep this key in a safe place as it provides access to your account and therefore charging to it. For security we keep no record of it, so it cannot be recovered if it is lost.
    keyGen
  3. With the API key you can now browse to the API documentation at https://vercator.cloud/swagger-ui.html
  4. The Swagger page provides both a sandbox for testing the API in the browser with example json as well as documentation of the endpoints. Alternatively, you can visit the raw text API documentation page (https://vercator.cloud/api/v0/public/doc) to import the details into other API tools, such as Postman.

Endpoints

There are currently four endpoints which are available and documented:

  1. Create a project – enables the programmatic creation and running of a project using data from public url’s. Currently export is not supported but is under development.
  2. Get a project – provides the status of a project; whether it is running, completed etc.
  3. Share a project – generates a unique link for one user to view a project’s page of the coarse and fine results visualisation only.
  4. Generates a public link to an exported scan – creates a unique link, valid for 1 hour, to the exported registered scan requested.

Example usage:

Generate a project with the ‘Create a project’ endpoint, poll ‘Get a project’ every 15 seconds to find out when the jobs (pre-process, coarse, fine, export) are complete. Once coarse or fine registration stages are complete, a white-label visualisation page link can be generated with ‘Share a Project’. After the export has been completed urls for each scan can be created to access the final registered datasets.

Swagger UI Page

You can use the Swaggar page to do simple tests with the API endpoints. Firstly, press Authorise and input ‘Bearer [your API key]’ e.g. Bearer MTV9.aibNJRVEz. This will turn all the locks to locked status.

Then an endpoint can be selected and you can click Try it Out:

This will open an example of the data to be sent, such as json parameters or a project id field:

This can be edited and then run by pressing Execute. After which the response is displayed with status code.