링크 프로젝트 API 레퍼런스

이벤트 단위로 단축 URL·캠페인 링크를 묶고 합산 통계를 봅니다 (7개 엔드포인트)

GET /api/v1/service/link-projects

프로젝트 목록을 만든 순서 최근부터 조회합니다.

Query Parameters

Response

content[] 의 각 항목은 아래와 같고, page·size·totalElements·totalPages 가 함께 옵니다.

POST /api/v1/service/link-projects

프로젝트를 만듭니다 (PRO 이상). 성공하면 201 과 프로젝트를 돌려줍니다.

Request Body

Example

{
  "name": "10월 가을 이벤트",
  "description": "인스타·카카오·문자 링크"
}

GET /api/v1/service/link-projects/{id}

프로젝트 한 건과 링크 수를 조회합니다. 속한 링크 목록은 URL·캠페인 목록 API 에 projectId 를 넘겨 조회합니다.

Response

PUT /api/v1/service/link-projects/{id}

이름·설명을 바꿉니다 (PRO 이상). 이름은 필수이고, 설명을 비우면 지워집니다.

Request Body

POST /api/v1/service/link-projects/{id}/items

이미 있는 링크를 프로젝트에 넣습니다 (PRO 이상). 다른 프로젝트에 있던 링크는 이 프로젝트로 옮겨집니다. 하나라도 이 조직 링크가 아니거나 없는 ID 면 전부 거부합니다(404).

Request Body

Example

{
  "urlIds": [101, 102],
  "campaignIds": [55]
}

Response

POST /api/v1/service/link-projects/{id}/items/remove

이 프로젝트에서 링크를 뺍니다. 요금제 제한이 없습니다. 다른 프로젝트에 속한 링크는 건드리지 않습니다.

Request Body

Response

GET /api/v1/service/link-projects/{id}/stats

합산 통계를 조회합니다. 링크별 수의 합계이며, 여러 링크를 누른 같은 사람은 링크마다 따로 셉니다(순방문자는 제공하지 않습니다). 날짜는 조직 시간대 기준입니다.

Query Parameters

Response