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.
/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. (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": {
"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
webhookEnableYntiene el valorY.
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
¿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
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
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