CLP - Solicitud HTTP Generar vale de acceso – Centro de asistencia

¿Quieres conectarte a una aplicación de terceros más allá de los Conectores premium prediseñados de Workiva? Para ello, utiliza los comandos del conector de solicitudes HTTP para interactuar con las API REST.

En esta Ruta de aprendizaje conectada, crearemos una Cadena que se autentique con una API de terceros para obtener un Token de portador. Aunque lo demostraremos utilizando la API de Workiva, los principios y el proceso pueden aplicarse para conectar con otras API.

Caso de uso empresarial principal	Conectando a sistemas de terceros
Objetivo principal de aprendizaje	Aprender los Conceptos básicos de Cadenas y aprovechar los Comandos del Conector de Solicitudes HTTP de Workiva para conectarse y autenticarse en API REST de terceros.
Objetivo de aprendizaje secundario	Crear variables de espacio de trabajo
Requisitos previos	Configurar la concesión de API de Workiva Configurar el conector de solicitudes HTTP
Plantilla de ayuda	CLP \| Generar token de acceso

Paso 1: Crear variables de espacio de trabajo.

Para utilizar los datos de la API Workiva en varias Cadenas y Comandos, crearemos Variables del Espacio de Trabajo para almacenar esa información. Crearemos tres Variables de espacio de trabajo para los siguientes datos: API Conceder ID de cliente y Secreto de cliente, y URL base de IAM (gestión de identidad y acceso).

Desde Generador de cadenas, navega a Configuración del espacio de trabajo.
En Variables del Espacio de Trabajo, haz clic en el signo más (+) tres veces para crear tres Variables del Espacio de Trabajo y configúralas como sigue:
- Variable 1:
  - Nombre: wsv-Workiva API ID de cliente
  - Valor: Entrada: Id de cliente de tu Concesión de API.
    Para encontrar el Id de cliente, navega hasta tu Perfil dentro de la Plataforma Workiva y localiza la Concesión de API en la pestaña Seguridad.
    Sigue estas instrucciones para obtener más ayuda con las Concesiones de API.
- Variable 2:
  - Nombre: wsv-Workiva API Secreto de cliente
  - Valor: Entrada: Id de cliente de tu Concesión de API.
    Para encontrar el Secreto de cliente, navega hasta tu Perfil dentro de la Plataforma Workiva y localiza la Concesión de API en la pestaña Seguridad.
    Sigue estas instrucciones para obtener más ayuda para encontrar tu Secreto de cliente.
  - Haz clic en el botón de bloqueo para cifrar tu Secreto de cliente.
    
    Es importante mantener a salvo los Secretos de cliente; guarda el Secreto de cliente en una ubicación segura por si necesitas acceder a él de nuevo.
- Variable 3:
  - Nombre: wsv-BaseURL-IAM
  - Valor: Introduce el valor de abajo en función de tu región. Puedes verificar la región comprobando la URL. Si la URL contiene UE o APAC, utiliza el URL correspondiente.
  Nota: La región de EE.UU. solo contiene "aplicación".
  Campo Valor US
  
  URL base IAM https://api.app.wdesk.com
  
  Campo Valor UE
  
  URL base IAM https://api.eu.wdesk.com
  
  Campo Valor APAC
  
  URL base IAM https://api.apac.wdesk.com
- Guarda la Configuración del espacio de trabajo.

Etapa 2: Crea una Cadena

Para generar el Token de portador, crearemos una nueva Cadena con un comando POST; esto nos dará el Token de portador que necesitamos.

Navega hasta la pestaña Cadenas dentro del Generador de cadenas.
Crea una nueva Cadena y asígnale un nombre: CLP | Generar token de acceso.
Incluir un Descripción: Esta cadena genera un nuevo código de acceso a la API de Workiva. Debes proporcionar un Id. de cliente y un Secreto de cliente válidos de una Concesión de API generada previamente en los valores de las variables que aparecen a continuación.
Guarda la cadena.

Etapa 3: Recuperar un token

Esta cadena utiliza un comando POST del conector de solicitudes HTTP para recuperar nuestro token de portador. Un Token de portador es una credencial de autenticación crucial necesaria para acceder a las API. Una vez obtenido dentro de la Cadena, el token puede utilizarse dentro de los Comandos posteriores para proporcionar autorización para interactuar con la API.

Agregar un comando Publicar desde el conector Solicitud HTTP al área de Inicio.
Haz clic dos veces en el Comando para configurarlo.
- Cambia el nombre del comando: POST - Recuperar un Token.
- Marca la casilla Mostrar respuesta.
- Rellena el campo URL con la URL del punto final al que necesitas acceder. Para recuperar un token para la API de Workiva, rellena la URL con lo que se indica a continuación, utilizando la variable del Espacio de trabajo para rellenar la URL base de IAM.
  1. Haz clic en URL y, a continuación, haz clic en Espacio de trabajo en el panel "Seleccionar una variable", y selecciona la variable que creaste en el Paso 1 (wsv-BaseURL-IAM).
  2. Añade /oauth2/token después de la variable.
- En el campo Tipo de contenido, introduce: application/x-www-form-urlencoded.

Utiliza el signo Más para añadir un campo Encabezado .
- Tecla: Aceptar
- Valor: application/json

Utilice el signo Más para añadir otro campo Cabecera .
- Clave: Versión X
- Valor: 2026-01-01

Le diremos al punto final cómo ejecutarlo utilizando los parámetros introducidos en el Formulario de publicación. Por hacer eso, haz clic en el botón verde más junto a la sección Formulario 4 veces y rellena cada campo con los valores de abajo, prestando especial atención a las mayúsculas y minúsculas.

Campos 1:
- Nombre: client_id
- Valor: <wsv-Workiva>
  En el panel Seleccionar una variable, haz clic en la flecha hacia abajo para expandir Espacio de trabajo y selecciona wsv-Workiva API ID de cliente.
Campo 2:
- Nombre: client_secret
- Valor: <wsv-Workiva>
  En el panel Seleccionar una variable, haz clic en la flecha hacia abajo para expandir Espacio de trabajo y selecciona wsv-Workiva API Secreto de cliente.
Campo 3:
- Nombre: grant_type
- Valor: client_credentials
Campos 4:
- Nombre: ámbito
- Valor: Agregar un valor aquí para especificar a qué ámbitos debería tener acceso este token.

Rellena la Respuesta con la carga útil de ejemplo que aparece a continuación; al hacer esto, estamos proporcionando un formato a la salida del comando, facilitando el uso de cada variable devuelta.
```
{ "testigo_acceso": "cadena", "expires_in": "entero", "ámbito": "cadena", "tipo_token": "cadena" }
```

(Opcional) Introduce una Descripción: "Este comando HTTP ejecuta una llamada POST para generar un token de acceso necesario para la autenticación en comandos HTTP posteriores utilizando la API IAM de Workiva". Este comando aprovecha las Variables del Espacio de Trabajo para almacenar la URL base de la API IAM de Workiva y la API Conceder ID de cliente y Secreto de cliente. Más información en: https://developers.workiva.com/2026-01-01/tokenrequest.html".
Guarda el comando.

¡Consejo! Para determinar cómo rellenar los Campos de Formulario y Respuesta, consulta la documentación para desarrolladores del punto final de la API al que te estás conectando. Para la API de Workiva, puedes encontrar la documentación del Token de portador aquí.

Etapa 4: Evalúa el Ejercicio

Ahora que la Cadena está completa, evalúa el resultado.

Publica en la Cadena.
Haz clic en Ejecutar y luego en Ejecutar cadena.
Una vez que la Cadena haya completado su ejecución, deberías ver que se ha generado el token de acceso dentro de la pestaña Resultados - Cuerpo de la respuesta del comando Post.

Consulta el siguiente ejercicio de la Ruta de aprendizaje conectada a la solicitud HTTP para aprender a utilizar el Token de portador en una lista de comandos posterior Hojas de cálculo.

Soporte técnico

Comunidad

Centro de soporte de Workiva