링크 그룹 목록
링크 그룹 목록 API는 사용자가 생성한 모든 링크 그룹의 정보를 조회할 수 있는 기능을 제공합니다.
링크 생성 시 특정 그룹을 지정하려면, 먼저 이 API를 통해 그룹 목록을 조회한 뒤 원하는 그룹의 IDX 값을 확인해야 합니다.
이 IDX 값을 링크 생성 요청에 포함하면, 해당 그룹의 설정이 자동으로 링크에 적용되어 보다 효율적인 관리가 가능합니다.
Http Header
GET /api/link-group/v1/list
Host: https://vivoldi.com
Authorization: APIKey {Your API Key}
Content-type: -
User-agent: {Your User-agent}
Accept-Language: en
Request
{
"nm": "My group"
}| 필드 | 필드 설명 | 설명 | 필수 | 유형 |
|---|---|---|---|---|
| grpIdx | 그룹 IDX | 지정한 그룹의 IDX로 정확히 일치하는 그룹을 조회합니다. | int | |
| nm | 그룹 이름 | 그룹 이름에 포함된 텍스트로 그룹을 검색합니다. 이름 전체가 일치하지 않아도 일부만 포함되면 조회됩니다. | string |
Response
{
"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",
"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",
"kakaoNotifyYn":"N",
"pushNotifyYn":"Y",
"mailNotifyYn":"N",
"regYmdt":"2024-07-20 02:42:00",
"modYmdt":"2025-02-12 11:20:50"
}
]
}| 필드 | 설명 | 유형 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | 응답 코드 (0:성공) | int | ||||||||||||||||||||||||||||||||||||||||||||||||
| message | code가 0이 아닌 경우에 포함되며, 실패 원인을 설명하는 오류 메시지가 담겨 있습니다. | string | ||||||||||||||||||||||||||||||||||||||||||||||||
| result |
| array |