Please enable JavaScript to view this site.

 
It is the Resource Server and access point to the data. Allows restricting access to the files and, with the use of the Scopes, limit the operations available for this resource.

 

We can define as many API Resources as we need, always bearing in mind that all the API Resources we define will be executed in the same instance of LinkarWS.
In this section we will define all the resources provided by each API. These resources will be translated into the list of EndPoints that each API will support. Through Scopes, we will indicate the files, subroutines and commands accessible by the client.
 
Once defined,we will be able to generate the Swagger file with the entire list of operational EndPoints from this API Resource.

 

Field

Type

Description

New

Button

Create an API Resource.

Delete Selected

Button

Deletes the selected API Resources from the Database.

Export Selected

Button

Exports the selected API Resources to a JSON file.

Import from file

Button

Import API Resources from a JSON file.

Pencil Icon

Button

Edit the API Resource.

Trash Icon

Button

Deletes the API Resource.

Copy Icon

Button

Creates an API Resource by copying data from an existing API Resource.

 

Create/Edit/Copy API Resource

 

Field

Type

Description

Cancel

Button

Discard the changes and close the form.

Create/Update

Button

Save the ApiResource.

Name

Required

Name of the API that will be part of the requests url. Only numbers and letters.

Swagger Display Name

Optional

Name shown in the Swagger documentation.

Linkar EntryPoint

Required

Indicates the EntryPoint this API Resource is linked to.

Description

Optional

ApiResource description

Allowed CRUD MV Files

Optional

List of MV files that will be allowed to perform CRUD operations. If this field is empty we will allow access to all the files of the data account and the control will depend on the enabled scope (crud, crud.read, ...).

The Generate Scopes button allows creating all the Scopes of the indicated files.

Allowed MV Subroutines

Optional

List of subroutines that can be executed from the API using the Subroutine function. If this field is empty we allow the execution of any subroutine as long as the scope functions.subroutine is enabled.

The Generate Scopes button allows creating all the Scopes of the indicated subroutines.

Allowed MV Execute Statements

Optional

List of commands executable from the API using the Execute function. Not indicating any means that we allow the execution of any command as long as the functions.execute scope is enabled.

The Generate Scopes button allows creating all the Scopes of the indicated commands.

Availables Custom EndPoints

 

List of available Custom EndPoints. Select the ones you want to use and move them to the "Allowed Custom EndPoints" list.

Allowed Custom EndPoints

Optional

List of Custom Endpoints that can be executed from the API. Not indicating any means that we will not allow to create scopes to allow the execution.

The Generate Scopes button allows creating all the Scopes of the indicated commands.

 

 

Scopes determine the resources available for this API Resource.

If we do not define any Scope, the API Resource will NOT ALLOW to perform ANY operation in LinkarWS.

 

 

 

 

 

Field

Type

Description

Available Scopes to add

Select

Single scope selection.

Add Scopes

Botón

Adds the selected Scope.

Generate All Scopes

Botón

Add all available Scopes to the list.

 

You can see the complete list of Scopes here