Identidad de la entidad

GET/api/v1/auth/marca

Servicio

https://auth.<dominio-de-tu-entidad>

Acceso

Público

Límite

Por dirección IP; ver cabeceras X-RateLimit-*

Devuelve la identidad visual vigente de la entidad: nombre, colores, logo, isotipo, favicon y los textos de la pantalla de inicio de sesión. Es público porque la pantalla de ingreso se pinta antes de iniciar sesión.

Úsalo para que un portal, una intranet o una app propia muestre la misma marca que Panteum, sin copiarla a mano.

Petición

No recibe parámetros ni requiere credenciales.

Cabecera	Obligatoria	Descripción
Accept: application/json	Recomendada	Formato de la respuesta.
If-None-Match	No	El ETag de una respuesta anterior. Si la marca no cambió, responde 304 sin cuerpo.

Ejemplos

curl

curl -s https://auth.serviciostic.net/api/v1/auth/marca \
  -H "Accept: application/json"

JavaScript

// Node.js 18+ (fetch nativo). Úsalo desde tu servidor: el endpoint no habilita
// llamadas desde el navegador de otros dominios (CORS).
const respuesta = await fetch('https://auth.serviciostic.net/api/v1/auth/marca', {
  headers: { Accept: 'application/json' },
});
if (!respuesta.ok) throw new Error(`HTTP ${respuesta.status}`);
const { data: marca } = await respuesta.json();
console.log(marca.nombre, marca.color_primario, marca.color_acento);

Python

# Python 3.8+ con la librería requests (pip install requests)
import requests

respuesta = requests.get(
    "https://auth.serviciostic.net/api/v1/auth/marca",
    headers={"Accept": "application/json"},
    timeout=10,
)
respuesta.raise_for_status()
marca = respuesta.json()["data"]
print(marca["nombre"], marca["color_primario"], marca["color_acento"])

Reemplaza auth.serviciostic.net (instancia de demostración) por auth.<dominio-de-tu-entidad>.

Respuesta 200 OK

Respuesta real de la instancia de demostración (marca Panteum por defecto):

{
  "success": true,
  "data": {
    "modo": "panteum",
    "nombre": "Panteum",
    "tagline": "hub de aplicaciones",
    "nombre_entidad": null,
    "color_primario": "#2D6BFF",
    "color_acento": "#19D3F0",
    "logo_url": null,
    "isotipo_url": null,
    "favicon_url": null,
    "logo_tipo": null,
    "isotipo_tipo": null,
    "login_titulo": "Todas las aplicaciones de tu entidad, en un solo hub.",
    "login_bullets": [
      "PAA, CDP y RP con trazabilidad",
      "PQRS y trámites con firmas y aprobaciones",
      "Reportes listos para entes de control",
      "Instalable como app en el celular"
    ],
    "contacto_correo": null,
    "contacto_sitio": null,
    "con_tecnologia_panteum": false,
    "es_default": true,
    "version": "ab4ddf549000ed21"
  },
  "message": null
}

Cabeceras relevantes: ETag (igual a data.version), Cache-Control: public, max-age=0, must-revalidate y X-RateLimit-Limit / X-RateLimit-Remaining.

Campos de data

Campo	Tipo	Descripción
modo	texto	panteum (marca Panteum), comarca (marca de la entidad «con tecnología Panteum») o marca_blanca (solo la marca de la entidad).
nombre	texto	Nombre visible.
tagline	texto o null	Frase corta bajo el nombre.
nombre_entidad	texto o null	Nombre oficial de la entidad.
color_primario, color_acento	texto	Colores en hexadecimal (#RRGGBB).
logo_url, isotipo_url, favicon_url	texto o null	Direcciones públicas de los archivos de marca; null si la entidad no subió uno.
logo_tipo, isotipo_tipo	texto o null	Formato del archivo (por ejemplo svg o png).
login_titulo	texto	Título de la pantalla de inicio de sesión.
login_bullets	lista de textos	Frases de la pantalla de inicio de sesión.
contacto_correo, contacto_sitio	texto o null	Contacto institucional publicado por la entidad.
con_tecnologia_panteum	booleano	true si debe mostrarse «con tecnología Panteum».
es_default	booleano	true si la entidad aún no personalizó su marca.
version	texto	Huella de la marca; cambia cada vez que la marca cambia.

Otras respuestas

HTTP	Cuándo
304 Not Modified	Enviaste If-None-Match con el ETag vigente: la marca no cambió.
429 Too Many Requests	Superaste el límite de peticiones por minuto.

Relacionado

• GET /api/v1/auth/marca/archivo/{logo|isotipo|favicon} devuelve el archivo binario del logo, el isotipo o el favicon (las URL de logo_url, isotipo_url y favicon_url ya apuntan ahí).