Create from Connector

Es posible crear recursos desde connectors (conectores) que están habilitados en la Plataforma. Lea más sobre conectores y cómo habilitarlos aquí.

Para crear un recurso a partir de un conector, hacer clic en el botón Create from Connector en la pantalla de edición de recursos de una API (en el menú APIs). Se muestran todos los conectores habilitados para conexión y también se puede buscar por nombre de conector.

resourceFromConnector

Después de seleccionar un conector, hacer clic en la opción Create using instruction. Insertar el nombre del recurso (Resource Name), que es obligatorio, y una descripción, si lo desea.

Una vez creado el recurso, el usuario será redirigido a la pantalla de edición, donde podrá agregar operaciones para el recurso (haciendo clic en Add New Operation).

Insertar el método HTTP (obligatorio), la ruta (path, obligatoria) y la descripción (no obligatoria). En el área para describir la instrucción (Instruction), cada conector tendrá sus palabras reservadas con la función Autocompletar para ayudar a crear la sentencia.

resourceFromConnector addOperation

En el ejemplo anterior, estamos creando una operación POST para un conector de AWS Lambda, que responderá en el recurso /aws. El campo Instruction incluye la información esperada por la función.

El campo Instruction comprende la sintaxis nativa del protocolo al que el conector permite acceso. Un ejemplo para database connectors: al pasar una sentencia a un conector de tipo Oracle, no se permite el uso de ; al final de la instrucción, a diferencia de un conector MySQL, donde se utiliza ;.

Otro ejemplo de este paso es la imagen de abajo. En este caso (desde un conector SQL), la operación registrada devuelve una consulta en una tabla de base de datos. Más específicamente, el resultado será un JSON con los datos de consulta en la tabla users (path) y siguiendo la instrucción registrada.

resourceFromConnector addOperationGET

Puede utilizar parámetros de header, path, query o body en la instrucción para el conector. Para esto, basta utilizar las variables $headerParam.NOMBRE_HEADER, $queryParam.NOMBRE_QUERY, $pathParam.NOMBRE_PATH o $body.NOMBRE_ATRIBUTO.

Tenemos una página para ayudar con la sintaxis de las variables de conectores.

Volviendo al ejemplo del conector AWS Lambda, el recurso que se va a guardar en la API tendrá una etiqueta de conector:

resourceFromConnector resourceLabel

La API debe implementarse en el mismo entorno donde está configurado el conector. El despliegue de la API se hace en la sección Environments de la pantalla Overview de la API.

resourceFromConnector environments

Después de guardar la API, puede realizar una petición al recurso que se ha configurado.

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]