API de actualización de grupos de enlaces
Gestiona y actualiza múltiples enlaces cortos al mismo tiempo mediante grupos.
Modifica configuraciones a nivel de grupo para optimizar el control de campañas y actualiza en bloque opciones como caducidad, contraseña y webhooks.
Al cambiar la configuración del grupo, se aplica a todos los enlaces incluidos.
Si hay conflicto entre configuraciones individuales y de grupo, prevalecen las del grupo.
PUT
/api/link-group/v1/update
{
"grpIdx": 5066,
"nm": "Instagram Group",
"memo": "A group of links used in Instagram ads.",
"strtYmdt": "2026-03-01 00:00:00",
"endYmdt": "2026-03-31 23:59:59",
"expireUrl": "https://example.com/event-expired"
}
Request Parameters
- grpIdx integer required
-
IDX del grupo.
Especifique el IDX del grupo que desea actualizar. - nm string
-
Nombre del grupo.
Define el nombre del grupo utilizado para organizar y administrar enlaces. - memo string
-
Nota interna del grupo.
Puedes registrar libremente información de administración o el propósito del grupo. - notfSubscYn string
- Default:N
-
Enum:
YN
-
Define si el enlace será un enlace de suscripción a notificaciones push.
Y: Se crea un enlace exclusivo para suscripción a notificaciones push.
N: Se crea un enlace normal.
Cuando un usuario accede a un enlace de suscripción, se mostrará una solicitud para suscribirse a notificaciones push del navegador. - qrBypassYn string
- Default:N
-
Enum:
YN
-
Define el comportamiento de redirección al acceder mediante un código QR.
Y: Redirige directamente a la URL original. (No se registran estadísticas de clics)
N: Redirige a la URL corta. (Los clics sí se registran en las estadísticas) - blockOverseasSticsYn string
- Default:N
-
Enum:
YN
-
Define si se excluyen accesos internacionales de las estadísticas.
Y: Los accesos desde el extranjero no se incluyen en las estadísticas.
N: Los accesos desde todos los países se incluyen en las estadísticas. - pushNotifyYn string
- Default:N
-
Enum:
YN
-
Define si se envían notificaciones push basadas en el número de clics.
Y: Se enviará una notificación push cuando se alcance el umbral configurado.
N: No se enviarán notificaciones push.
Esta función está disponible a partir del plan Personal. - mailNotifyYn string
- Default:N
-
Enum:
YN
-
Define si se envían notificaciones por correo electrónico basadas en el número de clics.
Y: Se enviará un correo cuando se alcance el umbral configurado.
N: No se enviarán correos electrónicos.
Esta función está disponible a partir del plan Personal. - nonmemberSticsPwd string
-
Contraseña para consultar estadísticas de clics como usuario no registrado.
Si deseas permitir que usuarios no registrados vean las estadísticas, establece la contraseña requerida para acceder a la página de estadísticas. - strtYmdt datetime
-
Fecha y hora de inicio de validez del enlace.
El enlace podrá utilizarse a partir de la fecha y hora especificadas.
Ejemplo:2026-03-01 00:00:00 - endYmdt datetime
-
Fecha y hora de expiración del enlace.
Después de la fecha indicada, el acceso al enlace será bloqueado.
Ejemplo:2026-03-31 23:59:59 - expireUrl string
-
URL a la que se redirige cuando el enlace ha expirado.
Si no se especifica, se mostrará una página de aviso predeterminada.
Ejemplo:https://example.com/event-expired - pwd string
-
Contraseña para acceder al enlace.
Si se establece, los usuarios deberán introducir la contraseña antes de acceder al destino. - acesMaxCnt integer
-
Número máximo de clics permitidos.
Si se supera el límite establecido, el acceso al enlace será bloqueado. (0significa sin límite) - webhookEnableYn string
- Default:N
-
Enum:
YN
-
Define si se utiliza Webhook.
El Webhook global debe estar habilitado.
Esta función solo está disponible en el plan Enterprise. - webhookCallbackUrl string
-
URL del servidor que recibirá los eventos Webhook.
Es obligatorio cuandowebhookEnableYnesY. Introduce el endpoint de tu servidor que recibirá los datos del evento.
Ejemplo:https://api.example.com/webhook - webhookMetric string
- Default:C
-
Enum:
CP
-
Criterio para activar el Webhook.
C: basado en el número de clics, P: basado en el número de usuarios (clics únicos) - webhookFrequency integer
- Default:1
-
Enum:
1501002003005001000
-
Frecuencia de envío del Webhook.
1: cada clic, 50: cada 50 clics, 100: cada 100 clics, 300: cada 300 clics, 500: cada 500 clics, 1000: cada 1,000 clics
{
"code": 0,
"message": "",
"result": null // When the ‘webhookEnableYn’ parameter is set to ‘Y’, a secret key is specified.
}
Response Parameters
- code integer
- Código de respuesta: 0 = Éxito, otros valores = Error
- message string
- Mensaje de respuesta. Si el código no es 0, se devuelve un mensaje de error.
- result string
-
Si
webhookEnableYntiene el valorY, se genera y se devuelve una secret key.
Si ya existe unwebhookSecretKeypara el grupo, no se generará ni se devolverá una nueva clave.
Cuándo usar esta API
Utiliza esta API cuando gestionar enlaces cortos uno por uno deja de ser eficiente.
- Desactivar varios enlaces de campaña a la vez o modificar su periodo activo
- Restringir el acceso a todos los enlaces tras finalizar un evento
- Aplicar la misma configuración a múltiples enlaces en un solo paso
Funciones clave e impacto de configuración
Esta API no solo actualiza enlaces, sino que define cómo funcionan a nivel operativo.
Control de acceso
- Restringir el acceso a usuarios no registrados
- Limitar el acceso al código QR → solo usuarios autorizados
Analítica y filtrado
- Excluir tráfico de bots → mejora directamente la precisión de los datos
Notificaciones
- Notificaciones push y por correo → respuesta en tiempo real a eventos
Programación
- Definir fechas de inicio y fin → activación y desactivación automática
Gestión de expiración
- Redirección tras expiración → mantener la experiencia del usuario
Webhooks
- Enviar datos a servidores externos → integración y automatización
Casos de uso
- Campañas de marketing: Desactivar todos los enlaces al finalizar una campaña y redirigir automáticamente a una URL de expiración
- Plataformas SaaS: Agrupar enlaces por funcionalidad y gestionar accesos y disponibilidad de forma centralizada
- Gestión a gran escala: Usar webhooks para sincronizar eventos de clic con sistemas internos en tiempo real
- Seguridad: Mantener la seguridad actualizando contraseñas periódicamente
Aspectos a tener en cuenta
- Los cambios en la configuración del grupo se aplican de inmediato a todos los enlaces
- Una configuración incorrecta de fechas puede restringir el acceso a todos los enlaces
- La entrega de webhooks puede retrasarse según la disponibilidad del servidor externo
- Cambiar los filtros de analítica puede afectar la interpretación de los datos existentes