Lista de Grupos de Enlaces

API para consultar la lista de grupos de enlaces.

Devuelve toda la información de los grupos de enlaces creados por el usuario.
Para asignar un grupo específico al crear un enlace, utiliza esta API para obtener la lista de grupos o revísala en el panel de control.

GET

/api/link-group/v1/list?nm={nm}

{
    "nm": "My+group"
}

Request Parameters

grpIdxinteger
Grupo de enlaces (IDX).
nmstring
Grupo de enlaces (Nombre). Se admite búsqueda parcial.
Si incluye espacios o caracteres Unicode, se recomienda la codificación URL. 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "idx":1,
            "nm":"Amazon Electronics",
            "memo":"Products between $100 and $500",
            "linkCnt":112,
            "blockOverseasSticsYn":"N",
            "notfSubscYn":"N",
            "kakaoNotifyYn":"N",
            "pushNotifyYn":"N",
            "mailNotifyYn":"N",
            "webhookEnableYn": "Y",
            "webhookCallbackUrl": "https://yourdomain.com/webhook/callback/vivoldi",
            "webhookMetric": "P",
            "webhookFrequency": 1,
            "regYmdt":"2024-07-20 02:30:00",
            "modYmdt":"2024-08-15 17:45:10"
        },
        {
            "idx":2,
            "nm":"XXX Advertiser Group",
            "memo":"2-year contract",
            "linkCnt":68,
            "blockOverseasSticsYn":"N",
            "notfSubscYn":"Y",
            "qrBypassYn":"N",
            "pushNotifyYn":"Y",
            "mailNotifyYn":"N",
            "webhookEnableYn": "N",
            "webhookCallbackUrl": null,
            "webhookMetric": "C",
            "webhookFrequency": 1,
            "regYmdt":"2024-07-20 02:42:00",
            "modYmdt":"2025-02-12 11:20:50"
        }
    ]
}

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.
resultarray
idxinteger
Grupo IDX.
nmstring
Nombre del grupo.
memostring
Nota para la gestión del grupo.
linkCntinteger
Número de enlaces en el grupo.
notfSubscYnstring
Indica si es un enlace de suscripción push.
qrBypassYnstring
Controla si se debe omitir el enlace corto al escanear un código QR y acceder directamente a la URL original configurada por el usuario.
Y: Redirige directamente a la URL original sin pasar por el enlace corto. (No se registran estadísticas de escaneo QR)
N: Pasa por el enlace corto antes de redirigir a la URL original. (Se registran estadísticas de escaneo QR)
pushNotifyYnstring
Indica si las notificaciones push de clics están activadas.
mailNotifyYnstring
Indica si las notificaciones por correo de clics están activadas.
webhookEnableYnstring
Enum:
YN
Activación del Webhook.
webhookCallbackUrlstring
URL de Callback del Webhook.
webhookMetricstring
Enum:
CP
Criterio de recepción del Webhook.
C: Basado en número de clics, P: Basado en usuarios únicos (clics únicos).
webhookFrequencyinteger
Enum:
1501002003005001000
Frecuencia de recepción 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.
regYmdtdatetime
Fecha de creación.
modYmdtdatetime
Fecha de modificación.