...

Introducción

Este tipo de Entidad se crea a partir de una API REST, ya sea externa a Onesait Platform o de la propia Plataforma. En el primer caso, los datos no serán almacenados en la Plataforma, sino que todas las operaciones sobre estas Entidades serán derivadas a la API REST.

Pasos

Crear la Entidad

Desde el Control Panel, navegaremos al menú de Development > My Entities.

...

De las distintas Entidades que vamos a poder crear, seleccionaremos la de «Creation from a REST API»:

...

Rellenar la información general

Esto nos abrirá el asistente de creación de Entidades, en donde al igual que el resto de Entidades tendremos que introducir una información básica:

...

Una vez rellena toda esta información, pulsaremos en el botón de «Continue» para terminar de configurar la Entidad.

...

Configurar las cabeceras

Si el servicio API REST requiere de una autorización para usarlo, ya sea básica o por API Key, podremos configurarlo en esta sección. Para ello deberemos activar la opción de «Enable Authentication».

...

En caso de que necesitemos utilizar algún otro tipo de cabecera, podremos definirlas en la siguiente sección:

...

Añadir las operaciones disponibles

Existen dos opciones para añadir operaciones al API REST; importarlas desde el Swagger del servicio API REST, o añadirlas a mano.

Importar operaciones desde Swagger

En este caso, añadiremos la URL del Swagger del API REST para importar las operaciones disponibles:

...

Definir las operaciones a mano

Si no se encuentra disponible un Swagger, o si no nos interesa tener todas las operaciones sino definir las que nos interese, podremos creadas a mano.

...

• Name: el nombre con el que identificaremos la operación. En este caso: «getAll».

• Path: la ruta de la operación a ejecutar. En este caso «all» (más información).

• Type: el tipo de operación que vamos a crear. En este caso «GET».

• Description: un pequeño texto descriptivo de la operación a crear. Aquí introduciremos cualquier descripción que nos parezca de interés.

• Default Operation Type: el tipo de operación que llevará a cabo.

Operaciones POST

Para poder realizar operaciones de tipo POST, es preciso definir el esquema de destino para que las operaciones de escritura se puedan llevar a cabo.

...

Completado este último paso, finalizaremos la creación de la Entidad pulsando en el botón de «Create»:

...

Comprobar los datos

Una creada la Entidad, vamos a poder consultar su contenido desde la herramienta de consulta que encontraremos en Tools > Query Tool.

...