API de creación de grupos de enlaces

Crea grupos para gestionar enlaces cortos de forma más eficiente.

Organiza enlaces por categoría, aplica configuraciones en bloque y mantén una estructura clara.

Aplica configuraciones compartidas como caducidad, contraseña, webhooks y límites de clics a varios enlaces.

Si hay conflicto entre configuraciones individuales y de grupo, prevalecen las del grupo.

POST

/api/link-group/v1/create

{
    "nm": "Youtube Group",
    "memo": "A group of links included in the description section of a YouTube video.",
    "nonmemberSticsPwd": "123456"
}

Request Parameters

nm string required
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. (0 significa 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 cuando webhookEnableYn es Y. 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": {
        "grpIdx": 5066,  // group idx
        "webhookSecretKey": null  // When the ‘webhookEnableYn’ parameter is set to ‘Y’, a secret key is specified.
    }
}

Response Parameters

codeinteger
Código de respuesta: 0 = Éxito, cualquier otro valor = Error
messagestring
Mensaje de respuesta. Si el código no es 0, se devuelve un mensaje relacionado con el error.
resultobject
grpIdx integer
IDX del grupo.
webhookSecretKey string
Se devuelve una secret key cuando webhookEnableYn tiene el valor Y.

Cuándo usar esta API

Esta API es ideal cuando necesitas organizar y gestionar múltiples enlaces cortos de forma más eficiente.

  • Agrupar enlaces por categoría para una mejor organización
  • Separar enlaces por campaña para analizar el rendimiento con claridad
  • Gestionar enlaces por usuario o proyecto
  • Aplicar configuraciones a varios enlaces al mismo tiempo
Gestionar enlaces por grupos facilita la organización y permite escalar sin complicaciones.

¿Para qué sirve un grupo de enlaces?

Un grupo de enlaces te permite gestionar múltiples enlaces cortos como una sola unidad, facilitando la organización y el control.

  • Organizar y gestionar enlaces por grupo
  • Aplicar configuraciones comunes como notificaciones y restricciones de acceso
  • Separar análisis y métricas
  • Optimizar la gestión operativa
Una función clave para manejar grandes volúmenes de enlaces de forma eficiente.

Casos de uso

Esta API se adapta fácilmente a distintos escenarios.

  • Páginas de eventos: Controla el acceso por fechas con strtYmdt·endYmdt
  • Enlaces internos: Restringe el acceso con contraseña usando pwd
  • Enlaces con webhook: Recibe notificaciones inmediatas al hacer clic mediante webhookCallbackUrl
  • Otros: Organiza enlaces por categorías de productos o por cliente y equipo
A medida que aumenta el volumen de enlaces, la gestión se vuelve mucho más eficiente.

Aspectos a tener en cuenta

Antes de crear un grupo de enlaces, revisa los siguientes puntos.

  • Utiliza nombres claros y alineados con el objetivo de gestión
  • Las configuraciones del grupo pueden afectar a todos los enlaces incluidos
  • Una configuración incorrecta puede impactar la operación, por lo que requiere precaución
  • Puedes usar la API de actualización de grupos para realizar cambios cuando sea necesario
Una estructura de grupos bien definida es clave para una gestión eficiente.