Lista las plantillas visibles para el usuario de la sesión, con su configuración y propietario. Permite filtrar por identificador y tipo de integración. Devuelve un arreglo, que puede estar vacío. Esta consulta no devuelve un total en el encabezado Row-Count. El filtro compartidas tiene un comportamiento particular: cualquier valor enviado limita el resultado a las plantillas propias; omítelo para no aplicar ese filtro. La visibilidad también depende de los permisos de compartición.
Parámetros
Nombre
Tipo
Validación
Descripción
tkIntegracionPlantilla
varchar
Consulta: Identificador de una plantilla concreta. Hasta 64 caracteres.
compartidas
int
Consulta: Si se envía, limita el resultado a plantillas propias, incluso cuando vale 0.
tipoIntegracion
int
Consulta: Tipo de integración de las plantillas.
pagina
int
Consulta: Número de página, desde 1. Con 0 devuelve hasta 1000 registros.
cantidadRegistros
int
Consulta: Cantidad de registros por página.
token
String
Requerido
Encabezado: Token de sesión vigente obtenido al autenticarte. No lo registres ni lo expongas.
Respuesta
Nombre
Tipo
Descripción
indice
Integer
Posición del registro en el listado.
tkIntegracionPlantilla
String
Identificador de la plantilla.
nombre
String
Nombre de la plantilla.
configuracion
Object
Configuración guardada como JSON; puede ser null.
compartir
Integer
Valor de compartición guardado en la plantilla; puede ser null.
compartirTexto
String
Descripción de compartición: Empresa, Nadie o Grupo.
tkGrupo
String
Identificador del grupo del propietario; puede ser null.
grupo
String
Nombre del grupo del propietario; puede ser null.
tkUsuario
String
Identificador del propietario; puede ser null.
ejecutivo
String
Nombre del propietario.
iniciales
String
Iniciales del propietario; puede ser null.
orden
Integer
Clasificación de pertenencia usada en la presentación.
esPropia
Integer
1 si pertenece al usuario de la sesión; 0 en otro caso.
Solicitud
Consultar una página de plantillas
curl --request GET \
--url 'https://api.upnify.com/integraciones/plantillas?pagina=1&cantidadRegistros=50' \
--header 'Accept: application/json' \
--header 'token: TOKEN-SESION-EJEMPLO'async function ejecutar() {
const response = await fetch("https://api.upnify.com/integraciones/plantillas?pagina=1&cantidadRegistros=50", {
method: "GET",
headers: {"Accept": "application/json", "token": "TOKEN-SESION-EJEMPLO"}
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const data = text ? JSON.parse(text) : null;
// Usa data en tu aplicación sin exponer tokens o datos personales.
console.log("Estado HTTP:", response.status);
}
ejecutar().catch(console.error);// Node.js 18 o posterior.
async function ejecutar() {
const response = await fetch("https://api.upnify.com/integraciones/plantillas?pagina=1&cantidadRegistros=50", {
method: "GET",
headers: {"Accept": "application/json", "token": "TOKEN-SESION-EJEMPLO"}
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const data = text ? JSON.parse(text) : null;
// Usa data en tu aplicación sin exponer tokens o datos personales.
console.log("Estado HTTP:", response.status);
}
ejecutar().catch(console.error);import json
import requests
response = requests.request(
"GET",
"https://api.upnify.com/integraciones/plantillas?pagina=1&cantidadRegistros=50",
headers={'Accept': 'application/json', 'token': 'TOKEN-SESION-EJEMPLO'},
timeout=30,
)
response.raise_for_status()
data = response.json() if response.text else None
# Usa data en tu aplicación sin exponer tokens o datos personales.
print("Estado HTTP:", response.status_code)package main
import (
"fmt"
"io"
"net/http"
"time"
)
func main() {
request, err := http.NewRequest("GET", "https://api.upnify.com/integraciones/plantillas?pagina=1&cantidadRegistros=50", nil)
if err != nil { panic(err) }
request.Header.Set("Accept", "application/json")
request.Header.Set("token", "TOKEN-SESION-EJEMPLO")
client := &http.Client{Timeout: 30 * time.Second}
response, err := client.Do(request)
if err != nil { panic(err) }
defer response.Body.Close()
data, err := io.ReadAll(response.Body)
if err != nil { panic(err) }
if response.StatusCode < 200 || response.StatusCode >= 300 {
panic(fmt.Sprintf("HTTP %d: %s", response.StatusCode, data))
}
fmt.Println("Estado HTTP:", response.StatusCode)
}using System;
using System.Net.Http;
using System.Text;
using var client = new HttpClient();
using var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.upnify.com/integraciones/plantillas?pagina=1&cantidadRegistros=50");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("token", "TOKEN-SESION-EJEMPLO");
using var response = await client.SendAsync(request);
var data = await response.Content.ReadAsStringAsync();
response.EnsureSuccessStatusCode();
Console.WriteLine($"Estado HTTP: {(int)response.StatusCode}");