Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Conéctese a los servicios con OpenAPI
<a name="connectors-openapi"></a>

Para conectar App Studio con los servicios mediante OpenAPI para que los desarrolladores puedan crear aplicaciones que envíen solicitudes y reciban respuestas de los servicios, lleve a cabo los siguientes pasos:

1. [Obtenga el archivo de especificaciones de OpenAPI y recopile la información del servicio](#connectors-openapi-create-resources)

1. [Crear un conector OpenAPI](#connectors-openapi-create-connector)

## Obtenga el archivo de especificaciones de OpenAPI y recopile la información del servicio
<a name="connectors-openapi-create-resources"></a>

Para conectar un servicio a App Studio con OpenAPI, lleve a cabo los siguientes pasos:

1. Ve al servicio que deseas conectar a App Studio y busca un archivo JSON de especificación OpenAPI.
**nota**  
App Studio admite archivos de especificación de OpenAPI que se ajusten a la versión 3.0.0 o superior de la Especificación de OpenAPI.

1. Recopile los datos necesarios para configurar el conector OpenAPI, incluidos los siguientes:
   + La URL base para conectarse al servicio.
   + Credenciales de autenticación, como un token o un nombre de usuario o contraseña.
   + Si corresponde, cualquier encabezado.
   + Si corresponde, cualquier parámetro de consulta.

## Crear un conector OpenAPI
<a name="connectors-openapi-create-connector"></a>

**Para crear un conector para OpenAPI**

1. Ve a App Studio.

1. En el panel de navegación de la izquierda, selecciona **Connectors** en la sección **Administrar**. Se abrirá una página que muestra una lista de los conectores existentes con algunos detalles sobre cada uno.

1. Seleccione **\$1 Crear conector**.

1. Elija el **conector OpenAPI** de la lista de tipos de conectores. Ahora, configure su conector rellenando los siguientes campos.

1. **Nombre:** introduzca un nombre para el conector de OpenAPI.

1. **Descripción:** introduzca una descripción para su conector OpenAPI.

1. **URL base:** introduzca la URL base para conectarse al servicio.

1. **Método de autenticación:** elija el método de autenticación con el servicio de destino.
   + **Ninguno:** acceda al servicio de destino sin autenticación.
   + **Básico:** acceda al servicio de destino con un **nombre de usuario** y una **contraseña** obtenidos del servicio al que se está conectando.
   + **Token de portador:** acceda al servicio de destino utilizando el **valor de token** de un token de autenticación obtenido de la cuenta de usuario o de la configuración de la API del servicio.
   + **OAuth 2.0:** accede al servicio de destino mediante el protocolo OAuth 2.0, que permite a App Studio acceder al servicio y a los recursos sin compartir ninguna credencial o identidad. Para usar el método de autenticación OAuth 2.0, primero debes crear una aplicación desde el servicio al que estás conectado que represente a App Studio para obtener la información necesaria. Con esa información, rellena los siguientes campos:

     1. **Flujo de credenciales de cliente:**

        1. En el **ID de cliente**, introduzca el ID del servicio de destino.

        1. En **Secreto de cliente**, introduzca el secreto del servicio de destino.

        1. En la **URL del token de acceso**, introduzca la URL del token del servicio de destino.

        1. Si lo desea, en **Ámbitos**, introduzca los ámbitos de la aplicación. Los ámbitos son los permisos o niveles de acceso que requiere la aplicación. Consulta la documentación de la API del servicio de destino para entender sus ámbitos y configurar solo aquellos que tu aplicación de App Studio necesite.

        Agrega **las variables** que quieras enviar con el servicio en cada llamada y selecciona **Verificar conexión** para probar la autenticación y la conexión.

     1. **Flujo de códigos de autorización:**

        1. En **ID de cliente**, introduzca el ID del servicio de destino.

        1. En **Secreto de cliente**, introduzca el secreto del servicio de destino.

        1. En **URL de autorización**, introduzca la URL de autorización del servicio de destino.

        1. En **URL del token de acceso**, introduzca la URL del token del servicio de destino.

        1. Si lo desea, en **Ámbitos**, introduzca los ámbitos de la aplicación. Los ámbitos son los permisos o niveles de acceso que requiere la aplicación. Consulta la documentación de la API del servicio de destino para entender sus ámbitos y configurar solo aquellos que tu aplicación de App Studio necesite.

1. **Variables:** agrega variables para enviarlas al servicio con cada llamada. Las variables agregadas durante la configuración se almacenan de forma segura y solo se accede a ellas durante el tiempo de ejecución de las aplicaciones que utilizan la conexión.

1. **Encabezados:** agregue encabezados HTTP que se utilizan para proporcionar metadatos sobre la solicitud o la respuesta. Puede agregar claves y valores, o solo proporcionar una clave a la que el generador pueda proporcionar un valor en la aplicación.

1. **Parámetros de consulta:** añada parámetros de consulta que se utilizan para transferir opciones, filtros o datos como parte de la URL de la solicitud. Al igual que los encabezados, puedes proporcionar tanto una clave como un valor, o solo puedes proporcionar una clave a la que el generador pueda proporcionar un valor en la aplicación.

1. Archivo de **especificaciones de OpenAPI: cargue un archivo** JSON de especificación OpenAPI arrastrándolo y soltándolo, o seleccionando **Seleccionar un archivo** para navegar por su sistema de archivos local y elegir el archivo que desea cargar.

   Una vez agregado, el archivo se procesa y se muestra una lista de las opciones disponibles. Seleccione las operaciones necesarias para el conector.

1. Seleccione **Crear**. El conector recién creado aparecerá en la lista de **conectores**.

Ahora que se ha creado el conector, los desarrolladores pueden usarlo en sus aplicaciones.