Upnify Documentación API
Inicia aquí · /integraciones/:tkIntegracion

Integraciones

Consultar el detalle de una integración

GET/integraciones/:tkIntegracion

Consulta los datos de una integración de la cuenta. Devuelve un arreglo, incluso si coincide una sola integración, y el total en Row-Count. Usa el identificador completo obtenido del listado para evitar coincidencias parciales. La configuración y el token de integración pueden contener credenciales; no los publiques.

Parámetros

NombreTipoValidaciónDescripción
tokenStringRequeridoEncabezado: Token de sesión vigente obtenido al autenticarte. No lo registres ni lo expongas.
tkIntegracionStringRequeridoURL (obligatorio): Identificador de la integración.
tipoIntegracionIntegerConsulta: Filtro adicional por un tipo de integración.
paginaIntegerConsulta: Número de página, desde 1. Con 0 devuelve hasta 1000 registros.
cantidadRegistrosIntegerConsulta: Cantidad de registros por página.

Respuesta

NombreTipoDescripción
indiceIntegerPosición del registro dentro del resultado ordenado.
tipoIntegracionIntegerTipo de integración.
fechaIntegracionStringFecha de creación, sin indicador de zona horaria.
configObjectConfiguración JSON de la integración. Puede contener credenciales; no la publiques. Puede ser null.
tkIntegracionStringIdentificador de la integración.
urlIntegracionStringURL para recibir datos de la integración. Incluye una credencial: no la publiques.
tkSesionIntegracionStringToken completo de integración. No lo registres ni lo expongas.
idFormularioStringIdentificador para recuperar la configuración del formulario.
ultimoUsoStringFecha del último uso; puede ser null.
mapeoObjectMapa JSON entre los campos de entrada y los campos de Upnify; puede ser null.

Solicitud

Obtener el detalle de una integración

curl --request GET \
  --url https://api.upnify.com/integraciones/AP00000000-0000-4000-8000-000000000001 \
  --header 'Accept: application/json' \
  --header 'token: TOKEN-SESION-EJEMPLO'

Respuesta

Detalle de integración (HTTP 200)

JSON
[
  {
    "indice": 1,
    "tipoIntegracion": 7,
    "fechaIntegracion": "2026-09-22 09:00:00.000",
    "config": {
      "nombre": "Formulario de ejemplo"
    },
    "tkIntegracion": "AP00000000-0000-4000-8000-000000000001",
    "urlIntegracion": "https://api.salesup.com/integraciones/P01AP00000000-0000-4000-8000-000000000001",
    "tkSesionIntegracion": "P01AP00000000-0000-4000-8000-000000000001",
    "idFormulario": "eyJlIjoxMjMsInQiOiJUT0tFTi1JTlRFR1JBQ0lPTi1FSkVNUExPIn0",
    "ultimoUso": null,
    "mapeo": {
      "email": "correo"
    }
  }
]