Saltar al contenido principal

Nodo api

Este nodo permite interactuar con diversas API, lo que es útil para la integración con servicios externos.

Configuración del nodo API​

IMG2

1. Nombre​

Campo para especificar el nombre del nodo.
El nombre se muestra en el área de trabajo y ayuda a identificar fácilmente el nodo.
Si se deja vacío, el nodo se llamará API.

Ejemplo:

  • Nombre del nodo: Crear Sesión de Pago

2. Método​

Aquí se selecciona el método de la API que se utilizará para enviar la solicitud. Métodos disponibles:

  • "Crear Sesión de Pago":
    Crea una nueva sesión de pago.

  • "Actualizar Sesión de Pago":
    Actualiza una sesión de pago existente.

  • "Obtener Sesión de Pago por ID":
    Obtiene información sobre la sesión de pago mediante un identificador único de sesión.

  • "Obtener Sesión de Pago por ID de Pedido":
    Obtiene información sobre la sesión de pago utilizando el identificador del pedido.

Ejemplo:

  • Método: Crear Sesión de Pago

3. Datos​

Este campo utiliza la plantilla Mustache para formar los datos de la solicitud en formato JSON.
Puede utilizar datos del mensaje msg para sustituir valores en la plantilla.

Ejemplo de plantilla (para el método "Crear Sesión de Pago"):

 {
   "orderId": {{orderId}},
   "type": "session"
 }

En este ejemplo, el valor orderId se sustituirá del mensaje msg.

Ejemplo de plantilla (para el método "Actualizar Sesión de Pago"):

 {
   "id": {{paymentSessionId}},
   "paymentUrl": "{{{payload.links.1.href}}}"
 }

Al utilizar plantillas Mustache, puede pasar datos y parámetros complejos necesarios para interactuar con la API.

Ejemplos de solicitudes​

Ejemplo 1: Crear sesión de pago​

Configuración del nodo:

  • Método: Crear Sesión de Pago
  • Datos: 
    {
      "orderId": {{orderId}},
      "type": "session"
    }

Mensaje:

{
  "orderId": 123
}

Resultado:
El nodo enviará una solicitud para crear una sesión de pago con los datos del mensaje. Como resultado, se obtendrá información sobre la nueva sesión de pago.

Ejemplo 2: Actualizar sesión de pago​

Configuración del nodo:

  • Método: Actualizar Sesión de Pago
  • Datos: 
    {
      "id": {{paymentSessionId}},
      "paymentUrl": "{{{payload.links.1.href}}}"
    }

Mensaje:

{
  "paymentSessionId": 123,
  "payload": {
    "id": "8YP51523N05861826",
    ....
    "links": [
      {
        "href": "https://api.sandbox.paypal.com/v2/checkout/orders/8YP51523N05861826",
        "rel": "self",
        "method": "GET"
      },
      {
        "href": "https://www.sandbox.paypal.com/checkoutnow?token=8YP51523N05861826",
        "rel": "payer-action",
        "method": "GET"
      }
    ]
  }
}

Resultado:
El nodo enviará una solicitud para actualizar el estado de la sesión de pago, utilizando los valores proporcionados payment_session_id y status.

Ejemplo 3: Obtener sesión de pago por ID​

Configuración del nodo:

  • Método: Obtener Sesión de Pago por ID
  • Datos: 
    {
      "id": "{{paymentSessionId}}"
    }

Mensaje:

{
  "paymentSessionId": 123
}

Resultado:
El nodo enviará una solicitud para obtener información sobre la sesión de pago mediante el identificador único de sesión.

Ejemplo 4: Obtener sesión de pago por ID de pedido​

Configuración del nodo:

  • Método: Obtener Sesión de Pago por ID de Pedido
  • Datos: 
    {
      "orderId": "{{payload.id}}"
    }

Mensaje:

{
  "payload": {
    "id": 1
  }
}

Resultado:
El nodo enviará una solicitud para obtener información sobre la sesión de pago asociada con el identificador de pedido especificado.