Skip to main content
GET
Consultar orígenes del SDK

Conceptos

El SDK de conexión resuelve { success: false } sin decir el motivo. En la práctica falla por dos caminos muy distintos, y este endpoint resuelve el primero.

Fallo 1 — origen no autorizado

El SDK solo funciona desde dominios registrados en allowOrigins. Si el origen del navegador no está en la lista, aborta con:
Usa este endpoint antes de llamar al SDK para saber si el origen actual está autorizado:
El dominio del panel de Omni Z-API se acepta siempre, aunque no figure en allowOrigins. Solo tienes que registrar tus dominios, incluido http://localhost:3000 para desarrollo.
El registro de orígenes se hace en el panel, en Seguridad. No hay endpoint público para eso.

Fallo 2 — popup bloqueado

El SDK abre una ventana con window.open. Si llamas a client.connect() después de un await, el gesto del usuario ya se perdió y el navegador bloquea el popup: el SDK también devuelve { success: false }.

Autenticación

Este es el único endpoint que acepta la Public Key, y va en crudo en el header, sin Bearer:
Es intencionado: el endpoint se llama desde el frontend, donde la Public Key se puede exponer.

Autorizaciones

Authorization
string
header
requerido

Parámetros de ruta

channelId
string
requerido

ID del canal

Ejemplo:

"019E4C54B1B375A28970B605CA9B03C3"

Respuesta

Orígenes del canal

allowOrigins
string[]

Orígenes permitidos para el SDK