API
El conector API permite hacer una llamada a una API pública y que la respuesta se guarde dentro del workfloo.
Es posible llamar a cualquier API. Los datos recibidos se pueden usar en los siguientes pasos del workfloo y están incluidos en los datos cuando se recupera el .json entero del flujo.
Crear un nuevo conector API
Haz clic en el menú Conectores > API
Datos a proporcionar
Ingresa los datos a proporcionar:
Ejemplo
| Dato | Descripción |
|---|---|
| Nombre | Nombre del conector |
| URL | Endpoint de la API, ej : https://api.nytimes.com/svc/books/v3/lists/best-sellers/history.json |
| Request Method | Tipo de método HTTP |
| Content-Type | Se envía como header Content-type |
| Headers | Lista de los headers a enviar |
| Query parameters | Lista de parametros a enviar. Son parametros que se envían en la URL |
| Body | Cadena de datos a enviar como tipo "raw" en la petición |
Ejemplo de una configuración :
En la URL, los valores de headers/parameters y en el body, se pueden usar variables que la plataforma va a sustituir.
Las variables se escriben dentro de llaves, con este formato: {{VARIABLE}}
| Variable | Descripción |
|---|---|
| FORM:<id_form>:api_id> | ejemplo : {{FORM:2:nombres}} Significa que queremos reemplazar la variable por el campo con API_ID "nombres" del conector formulario con id 2 |
| VP:<id_vp> | Por ejemplo {{VP:4}} toma el valor de la variable dinámica con ID 4. |
| WORKFLOO_ID | id del workfloo que se está ejecutando |
| WORKFLOO_API_KEY | API key del ambiente donde se ejecuta el workfloo |
| WORKFLOO_ENV | Si el workfloo se ejecuta en el ambiente de test, se reemplaza por https://test.unykoo.com Si el workfloo se ejecuta en el ambiente de producción, se reemplaza por : https://www.unykoo.com |
Por ejemplo, un body se podría escribir :
{
"nombres":"{{FORM:2:nombres}}"
}
y un parametro así :
Respuesta dentro del workfloo
Aquí está un ejemplo de un workfloo con una llamada a una API externa. Se puede descargar el .json del flujo para ver como esta estructurada la respuesta.
Responder
Content aside
Categorías
- Hace 4 mesesÚltimo activo
- 9Visitas
-
1
Siguiendo