Lista de Grupos de Enlaces (v2)

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/v2/list?nm={nm}&pages={pages} 

{
    "nm": "My+group",
    "pages": 1
}

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": {
        "extra": {
            "pages": 1,
            "nextPages": 1,
            "nextYn": "N",
            "count": 2,
            "totalCount": 2
        },
        "list": [
            {
                "idx":1,
                "nm":"Amazon Electronics",
                "memo":"Products between $100 and $500",
                "linkCnt":112,
                "blockOverseasSticsYn":"N",
                "notfSubscYn":"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

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 object
extra object
Información de página y número de datos.
pages integer
Número de la página actual
nextPages integer
Número de la siguiente página
nextYn string
Indica si existe una página siguiente
count integer
Número de registros en la página actual
totalCount integer
Número total de registros
list array
Información del Grupo
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.
qrBypassYn string
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.
webhookEnableYn string
Enum:
YN
Activación del Webhook.
webhookCallbackUrl string
URL de Callback del Webhook.
webhookMetric string
Enum:
CP
Criterio de recepción del Webhook.
C: Basado en número de clics, P: Basado en usuarios únicos (clics únicos).
webhookFrequency integer
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.