Liste de liens

API permettant de récupérer la liste des liens courts générés.

Cette API est disponible uniquement avec les forfaits Premium ou supérieurs.

GET

/api/link/v1/list?regStartYmdt={regStartYmdt}&regEndYmdt={regEndYmdt}&pages={pages}

{
    "regStartYmdt": "2025-09-01 00:00:00",
    "regEndYmdt": "2025-09-10 23:59:59",
    "pages": 1
}

Request Parameters

regStartYmdtdatetimerequired
Date de création du lien (Début). Spécifie la date de début de la requête.
Exemple : 2025-09-01 00:00:00
regEndYmdtdatetimerequired
Date de création du lien (Fin). Spécifie la date de fin de la requête.
Exemple : 2025-09-10 23:59:59
pagesintegerrequired
Numéro de page. La valeur par défaut est 1.
Chaque page renvoie 30 résultats par défaut. Par exemple, si pages=2, les résultats sont renvoyés à partir du 31e enregistrement.
linkIdstring
ID du lien.
domainstring
Domaine du lien.
createTypeIdxinteger
Méthode de création du lien.
0 : Tous les liens, 270 : Créé depuis le tableau de bord, 272 : Créé via l’API, 274 : Créé par import Excel.
grpIdxinteger
Groupe de liens.
urlstring
URL d’origine. La recherche partielle est prise en charge.
ttlstring
Titre du lien. La recherche partielle est prise en charge.
Si des espaces ou des caractères Unicode sont inclus, il est recommandé d’utiliser l’encodage URL.
brandLinkYnstring
Indique s’il s’agit d’un lien de marque.
memostring
Note de gestion du lien. La recherche partielle est prise en charge.
Si des espaces ou des caractères Unicode sont inclus, il est recommandé d’utiliser l’encodage URL.
notfSubscYnstring
Indique s’il s’agit d’un lien d’abonnement push.
blockOverseasSticsYnstring
Indique si les statistiques à l’étranger sont bloquées.
pushNotifyYnstring
Indique si les notifications push de clics sont activées.
mailNotifyYnstring
Indique si les notifications par e-mail de clics sont activées.
startDelYmdtdatetime
Date et heure de début de la suppression du lien.
endDelYmdtdatetime
Date et heure de fin de la suppression du lien. 
{
    "code": 0,
    "message": "",
    "result": {
        "extra": {
            "pages": 1,
            "nextPages": 1,
            "nextYn": "N",
            "count": 2,
            "totalCount": 2
        },
        "list": [
            {
                "linkId": "createpostinglinks",
                "domain": "https://vvd.im",
                "typeIdx": 103,
                "typeNm": "URL",
                "redirectType": 302,
                "ttl": "Add YouTube videos using post links to create short links",
                "description": "",
                "metaImg": "",
                "memo": "",
                "url": "https://vvd.im/createpostinglinks",
                "grpIdx": 0,
                "grpNm": "",
                "acesCnt": 5072,
                "acesCntToday": 315,
                "acesMaxCnt": 0,
                "pernCnt": 4958,
                "lastClkYmdt": "2022-11-07 04:45:10",
                "longUrl": "https://vivoldi.com/blog/url-shortener/create-posts-link-url-shortener",
                "blockOverseasSticsYn": "N",
                "notfSubscYn": "N",
                "kakaoNotifyYn": "N",
                "pushNotifyYn": "N",
                "mailNotifyYn": "N",
                "strtYmdt": "",
                "endYmdt": "",
                "expireUrl": "",
                "pwd": "",
                "nonmemberSticsPwd": "",
                "webhookEnableYn": "N",
                "webhookMetric": "C",
                "webhookFrequency": 1,
                "delYmdt": "",
                "regYmdt": "2022-11-02 04:27:05",
                "modYmdt": "2022-11-02 04:27:05"
            },
            {
                "linkId": "4Rth",
                "domain": "https://vvd.bz",
                "typeIdx": 103,
                "typeNm": "URL",
                "redirectType": 200,
                "description": "Discover diverse information and useful content on Naver's main page.",
                "metaImg": "https://s.pstatic.net/static/www/mobile/edit/2016/0705/mobile_212852414260.png",
                "ttl": "NAVER",
                "memo": "",
                "url": "https://vvd.bz/4Rth",
                "grpIdx": 128,
                "grpNm": "Test",
                "acesCnt": 19,
                "acesCntToday": 3,
                "acesMaxCnt": 1000,
                "pernCnt": 16,
                "lastClkYmdt": "2022-11-07 17:20:40",
                "longUrl": "https://www.naver.com",
                "blockOverseasSticsYn": "N",
                "notfSubscYn": "N",
                "kakaoNotifyYn": "N",
                "pushNotifyYn": "Y",
                "mailNotifyYn": "N",
                "strtYmdt": "2025-09-01 00:00:00",
                "endYmdt": "2025-09-30 23:59:59",
                "expireUrl": "https://yourdomain.com/event/closed.html",
                "pwd": "",
                "nonmemberSticsPwd": "123456",
                "webhookEnableYn": "Y",
                "webhookMetric": "C",
                "webhookFrequency": 1,
                "delYmdt": "2025-12-31 23:59:59",
                "regYmdt": "2022-11-07 17:10:22",
                "modYmdt": "2022-11-07 17:10:22"
            }
        ]
    }
}

Response Parameters

codeinteger
Code de réponse : 0 = Succès, autres valeurs = Erreur
messagestring
Message de réponse. Si le code n’est pas 0, un message d’erreur est renvoyé.
resultobject
extraobject
Informations sur la page et le nombre de données.
pagesinteger
Numéro de la page actuelle
nextPagesinteger
Numéro de la page suivante
nextYnstring
Indique s’il existe une page suivante
countinteger
Nombre d’enregistrements sur la page actuelle
totalCountinteger
Nombre total d’enregistrements
listarray
Informations sur le Lien
linkIdstring
ID du lien.
domainstring
Domaine.
typeIdxinteger
Default:103
Enum:
103104106107108119447
Type de lien (IDX). 103 : URL, 104 : Publication, 106 : Lien Profond, 107 : Bouton, 108 : Carte, 119 : QR, 447 : Formulaire.
typeNmstring
Type de lien (Nom).
redirectTypeinteger
Default:302
Enum:
200301302
Type de redirection.
Voir la page Terminologie pour plus de détails.
Cette fonctionnalité est disponible à partir du forfait Personnel.
ttlstring
Titre du lien.
memostring
Note de gestion du lien.
urlstring
URL courte.
grpIdxinteger
Groupe de liens (IDX).
grpNmstring
Groupe de liens (Nom).
acesCntinteger
Nombre total de clics.
acesCntTodayinteger
Clics d’aujourd’hui.
acesMaxCntinteger
Nombre maximum de clics autorisés.
pernCntinteger
Nombre d’utilisateurs uniques (clics uniques).
lastClkYmdtdatetime
Date du dernier clic.
longUrlstring
URL d’origine.
notfSubscYnstring
Indique s’il s’agit d’un lien d’abonnement push.
blockOverseasSticsYnstring
Indique si les statistiques à l’étranger sont bloquées.
pushNotifyYnstring
Indique si les notifications push de clics sont activées.
mailNotifyYnstring
Indique si les notifications par e-mail de clics sont activées.
strtYmdtdatetime
Date et heure de début de validité.
endYmdtdatetime
Date et heure de fin de validité.
expireUrlstring
URL de redirection après expiration.
pwdstring
Mot de passe d’accès au lien.
Doit être saisi pour accéder au lien.
nonmemberSticsPwdstring
Mot de passe des statistiques du lien.
Requis pour consulter les clics et les données analytiques. À partager uniquement avec les utilisateurs autorisés.
webhookEnableYnstring
Enum:
YN
Activation du Webhook.
webhookMetricstring
Enum:
CP
Critère de réception du Webhook.
C : Basé sur le nombre de clics, P : Basé sur les utilisateurs uniques.
webhookFrequencyinteger
Enum:
1501002003005001000
Fréquence de réception du Webhook.
1 : À chaque clic, 50 : Tous les 50 clics, 100 : Tous les 100 clics, 300 : Tous les 300 clics, 500 : Tous les 500 clics, 1000 : Tous les 1.000 clics.
delYmdtdatetime
Date planifiée de suppression du lien.
regYmdtdatetime
Date de création.
modYmdtdatetime
Date de modification.