Skip to main content

Catalog Application

Introduction

Catalog contains all published endpoints and their information. These endpoints are already created by producers, using Admin Application. For the purposes of Catalog analysis, they are expected to have already been created and visualized by Catalog, so no additional action is required.

Catalog is designed to be used by consumers, people that consume or invoke existing endpoints. It is a read-only view of the published artifacts, comprising business-related description, input/output information, security and invocation details. Each user can view and access only endpoints that is entitled to do so. This entitlement is accomplished with the usage of scopes

Access

The access to the Catalog Application is done through https://app.raw-labs.com. Click on Go To Catalog in order to be redirected to the Catalog Application.

RAW Labs app

Information

This is the main page of Catalog:

RAW Labs app

It adopts a simple visualization of the available endpoints All business-related information about a selected endpoint is shown in the Endpoint Description panel, as the following image shows:

The whole tab

tip

This information is retrieved from the yaml file of the endpoint.

All fields are analyzed below.

Title and description

The title and the description of the endpoint. These attributes are defined for informative purposes about the type and general functionality of this endpoint. Endpoint creators are free to specify arbitrary infomation within these attributes.

Title and description

Invocation Buttons

Power BI

Coming Soon

Please, contact us for more information!

Snowflake

Coming Soon

Please, contact us for more information!

RedShift

Coming Soon

Please, contact us for more information!

Invocation Details

The invocation details include the following attributes:

  • Path, which is the URL of this endpoint
  • Type of invocation endpoint, which is either GET or POST

Invocation Details

An endpoint may or may not receive input arguments. This is automatically deduced by RAW upon processing of the underlying RQL code. Here is an example of an parameterized endpoint:

Invocation Details

The invocation details provide the invocation URL and the type of invocation endpoint.

Data Details

Data details relate to the output payload of the selected endpoint. Two attributes are specified:

Data Details

Security

The endpoints can be Public or Private. Public endpoints are openly accessible by any user without prior authentication/authorization. Private endpoints are restricted to be accessbile by users with specific scopes. A scope is a list of tags (plain strings)

Here is an example of a public endpoint:

Security

Here is an example of a private endpoint with a specific scope, called iss:

Security

In order for endpoint consumers (requestors) to invoke this endpoint, the prerequisite is to obtain an Auth0 access token configured with the respective permission (iss), like this one:

{
...
"iat": 1649235181,
"exp": 1649321581,
"azp": "xxx",
"scope": "openid profile email",
"permissions": ["iss"]
}

Copy Invocation

In order for a user to actually consume an endpoint, Catalog exposes the corresponding automatically generated invocation code. At the moment only command-line invocations are supported, using the popular tool cURL. cURL is a computer software project providing a library and command-line tool for transferring data using various network protocols.

First select the endpoint to be consumed:

Copy Invocation

Click on Copy Invocation button and then choose cURL:

Copy Invocation

The cURL command for invoking the selected endpoint has been copied in your clipboard:

Copy Invocation

Free to to paste the code on a terminal:

curl 'https://dev-nuhynxsvnkentel.raw-labs.com/demos-raw-labs/1/public/ISS/isslocation'

The result, at the time of writing these lines, is the following:

"Pacific Ocean"