El conector Rest API transforma los datos a un formato JSON aplanado. Específicamente, el conector aplana todos los datos anidados en una única capa de pares de claves en una sola tabla.
Nota

El resultado máximo en JSON es de 10 MB y los datos no pueden tener más de 1.000 columnas.

Configura una nueva conexión

Completa los siguientes pasos para establecer una conexión en Minitab Connect.
  1. Desde la Inicio pantalla, selecciona el Agregar botón debajo Tablasde .
  2. En Conjuntos de datos, introduce la API REST y selecciona el conector de los resultados.
  3. Introduce una Nombre que identifica la conexión.
  4. En Variables, introduce hasta 15 pares clave-valor para almacenar y reutilizar valores. Introduce la clave en la primera casilla y el valor en la segunda. El nombre clave está limitado a 100 caracteres y solo puede contener letras, números, guiones (-) y guiones bajos (_). El conector valida y ejecuta el valor como una sentencia SQL si comienza con un paréntesis izquierdo y termina con un paréntesis derecho.

    Cuando almacenas un valor como variable, puedes consultarlo varias veces y solo tienes que actualizarlo en un solo lugar. Por ejemplo, si tienes la misma URL en más de una petición, pero la URL puede cambiar, introduce base_url como clave. Luego, introduce www.example.com como valor y usa {{base_url}} para referenciar la variable en tus solicitudes. Si la URL cambia, puedes cambiar el valor de base_url para actualizar la nueva URL en todas tus solicitudes usando la misma conexión automáticamente.

  5. En Autenticación, seleccione una de las siguientes opciones.
    Autenticación básica
    Introduce las credenciales del servicio web RESTful.
    Clave/token de API
    Introduce la clave API y el valor. Tipo de parámetro de autenticación deseado Si seleccionas Parámetro de encabezado , puedes hacer solicitudes GET y POST. Si seleccionas Parámetro del cuerpo , solo puedes hacer solicitudes POST.
    Token Bearer
    Ingrese el Token.
    Token JWT
    Selecciona generar tokens JWT y añádelos a la petición. Tipo de parámetro de autenticación deseado Si seleccionas Parámetro de encabezado, puedes hacer solicitudes GET y POST. Si seleccionas Parámetro del cuerpo , solo puedes hacer solicitudes POST.
    De Algoritmo, selecciona un algoritmo HS, RS o ES. Si seleccionas HS, introduce un Secreto para usar con el algoritmo. Si seleccionas RS o ES, Connect crea una Clave pública JWT después de guardar la conexión.
    OAuth 2.0
    Selecciona para acceder a datos con OAuth 2.0. Para más información sobre las opciones de este método de autenticación, visite la sección Establecer una nueva conexión con OAuth 2.0.
    Ninguno
    Selecciona si tu servicio web no requiere nombre de usuario y contraseña ni clave API
  6. Escoger Guardar.

Después de guardar la conexión, Connect muestra opciones para importar datos a una nueva tabla. Empieza en el paso 4 de la sección Crear una tabla con datos de una sección de conexión para obtener más información sobre cómo importar datos para crear una tabla.

Configurar una nueva conexión con OAuth 2.0

Completa los siguientes pasos para establecer una conexión en Minitab Connect usando el OAuth 2.0 método de autenticación. Acceder a datos con OAuth 2.0 suele implicar varias peticiones de ida y vuelta entre Connect y la API.
  1. Desde la Inicio pantalla, selecciona el Agregar botón debajo Tablas de .
  2. En Conjuntos de datos, introduce la API REST y selecciona el conector de los resultados.
  3. Introduce una Nombre que identifica la conexión.
  4. En Autenticación, seleccione OAuth 2.0.
  5. Tipo de parámetro de autenticación deseado Si seleccionas Parámetro de encabezado, puedes hacer solicitudes GET y POST. Si seleccionas Parámetro del cuerpo , solo puedes hacer solicitudes POST.
  6. En Tipo de concesión, seleccione una de las siguientes opciones.
    Código de autorización
    Selecciona autenticarte con el proveedor de servicios de la API. Se envía un código de autorización a la aplicación cliente, se extrae e intercambia con el proveedor a cambio de un token de acceso para autenticar futuras solicitudes.
    Implícito
    Selecciona devolver un token de acceso sin necesidad de pasar el paso extra del código de autorización. Esto lo hace menos seguro.
    Credenciales de contraseña
    Selecciona enviar un nombre de usuario y contraseña directamente desde el cliente. Si seleccionas este tipo de subvención, tienes que introducir el Nombre de usuario y Contraseña para tu proveedor de API.
    Credenciales del cliente
    Úsalo para acceder a datos asociados a la aplicación cliente.
  7. A continuación se muestra la lista completa de opciones para solicitar un nuevo token de acceso. Dependen del tipo de subvención.
    URL de devolución de llamada
    Debes añadir esta URL a las URLs de Callback registradas de tu aplicación.
    URL de autenticación
    Introduce el endpoint del servidor de autorización que quieres usar para obtener el código de autorización. Incluye cualquier parámetro no estándar que requiera el servicio.
    URL de token de acceso
    Introduce el endpoint del servidor de autorización que quieres usar para obtener el token de acceso.
    URL de actualización del token
    Introduce el endpoint del servidor de autorización que quieres usar para actualizar el token de acceso si es diferente al URL de token de acceso.
    ID de cliente
    El ID de tu aplicación cliente que registraste con el proveedor de la API.
    Secreto de cliente
    El secreto del cliente que recibiste al registrarte con el proveedor de la API.
    Alcance
    El alcance de la solicitud de acceso. Separa varios telescopios con un espacio.
    Autenticación del cliente
    Selecciona cómo quieres transmitir las credenciales del cliente cuando solicites un token de acceso.
  8. Si seleccionaste Código de autorización o Implícito como tipo de subvención, debes seleccionar Haga clic para autorizar antes de poder guardar la conexión.
  9. Escoger Guardar.

Después de guardar la conexión, Connect muestra opciones para importar datos a una nueva tabla. Comienza en el paso 4 de la siguiente sección para obtener más información sobre cómo importar datos para crear una tabla.

Crea una tabla con datos de una conexión

Completa los siguientes pasos para importar un archivo de datos desde una API y crear una nueva tabla en Connect. Si usas una variable en una caja de entrada, puedes pasar el cursor sobre la variable para ver su valor. Sin embargo, solo puedes referenciar una variable en la configuración de la tabla, no en la conexión. Debes definir la variable y guardar la conexión para referenciar una variable. Para más información, consulta el paso 4 en la sección "Configurar una nueva conexión".
  1. Desde la Inicio pantalla, selecciona el Agregar botón debajo Tablas de .
  2. En Conjuntos de datos, introduce la API REST y selecciona el conector de los resultados.
  3. En Conexión, selecciona la conexión de la API Rest que configuraste previamente. Si no has establecido previamente una conexión, selecciona Nueva conexión y sigue los pasos de la sección anterior.
  4. En el panel izquierdo, introduce a Nombre que identifica la tabla y selecciona a Carpeta para guardar la tabla.
  5. En Frecuencia de actualización, especifica con qué frecuencia quieres que Connect actualice la tabla. Puedes importar los datos una sola vez o hacer que Connect los importe continuamente en un intervalo de tiempo establecido. Connect crea automáticamente un flujo para tu importación. Si seleccionas Una vez, puedes usar el flujo más adelante para ejecutar automáticamente la importación de nuevo.
  6. En URL, introduce la URL base de la solicitud. Añadirás parámetros más adelante.
  7. Desde Tipo de solicitud, selecciona una solicitud HTTP GET o una solicitud HTTP POST .
  8. En Profundidad máxima de la matriz, selecciona la profundidad máxima en la que Connect convierte nodos de datos JSON en columnas de tabla. Los datos de la cadena JSON se convierten en el resultado del valor de la celda cuando Connect alcanza la profundidad máxima. Por defecto, la profundidad máxima de la matriz es 5.
  9. Seleccione Siguiente.
  10. En Parámetros del encabezado de la solicitud y Parámetros del cuerpo de la solicitud, introduce los parámetros de la solicitud que quieres enviar. Si usas una variable, puedes pasar el cursor sobre la variable para ver el punto final de la URL.
  11. Al principio no hay campos disponibles. Selecciona Agregar parámetro añadir pares de claves a los parámetros de la URL de la solicitud.
  12. En Clave de matriz para registros (ruta raíz), introduce el camino separado por coma hacia el nodo.
  13. Selecciona La respuesta separa los registros en varias páginas para añadir variables de paginación. Luego, desde Configuración de la variable de paginación, selecciona una de las siguientes opciones. Con cualquiera de las dos opciones, puedes analizar un máximo de 100 páginas.
    Parámetro del vínculo de la página siguiente
    Úsalo cuando continúes desde la respuesta anterior de la API y pasa página a página los resultados una página a la vez. El nombre del parámetro de página debe ser una lista de claves separada por comas. Estas claves encuentran el enlace de la siguiente página en la respuesta. Por ejemplo, "info, next".
    Parámetro de página y número de página inicial
    Úsalo cuando quieras acceso directo a un número de página conocido. Luego introduce el Variables de paginación.
  14. Escoger Guardar. Si vas a la Prep herramienta y seleccionas Corrida, Minitab Connect muestra los datos importados.
    Nota

    Si no aparecen datos después de seleccionar Corrida, selecciona Restablecer configuración.

Cuando guardas la importación, Connect crea un flujo con la configuración que seleccionaste. Para más información sobre cómo programar un flujo y añadir más procesos de datos para limpiar datos, visite a Resumen de la Flujo herramienta.

Lógica de aplanamiento JSON

Connect aplana los resultados JSON para representarlos correctamente como una tabla. Aplanar significa poner el JSON en una única estructura jerárquica para que no haya objetos hijos ni padres. Las columnas pueden representarse entonces, ya que todo es un par clave-valor. Los objetos anidados se muestran mediante un operador de punto en el nombre de la columna.