Main API
어필리에이트 API
제휴 상품 관리 API
어필리에이트 API
어필리에이트(제휴) 상품 관리 및 UTM 링크 생성 API입니다.
Base URL: /ai/appiliate
인증 정보
| 항목 | 값 |
|---|---|
| 인증 필요 | 부분적 |
| 인증 방식 | JWT Bearer Token |
엔드포인트 목록
| 메서드 | 경로 | 설명 | 인증 |
|---|---|---|---|
GET | /ai/appiliate/by-deadline | 마감일 순 상품 조회 | 불필요 |
GET | /ai/appiliate/{appiliateId} | 상품 상세 조회 | 부분적 |
POST | /ai/appiliate/utm-link/{affiliateId} | UTM 링크 생성 | 필요 |
API 상세
마감일 순 어필리에이트 상품 조회
마감일이 가까운 순으로 정렬된 어필리에이트 상품을 조회합니다.
HTTP 요청
GET /ai/appiliate/by-deadlineQuery Parameters
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
includeExpired | boolean | 아니오 | false | 만료된 상품 포함 여부 |
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "랜딩 어필리에이트 상품 리스트 조회 성공",
"data": [
{
"id": 1,
"title": "상품명",
"thumbnailImage": "https://...",
"brandName": "브랜드명",
"endDate": "2024-02-15",
"commissionRate": 10
}
]
}Response 스키마
| 필드명 | 타입 | 설명 |
|---|---|---|
id | long | 상품 ID |
title | string | 상품명 |
thumbnailImage | string | 썸네일 이미지 URL |
brandName | string | 브랜드명 |
endDate | string | 마감일 |
commissionRate | int | 수수료율 (%) |
어필리에이트 상품 상세 조회
상품 상세 정보를 조회합니다. 권한에 따라 UTM 링크 처리가 다릅니다.
- 크리에이터 (인증): UTM 링크 자동 발급
- 일반 사용자: 상품 정보만 반환
HTTP 요청
GET /ai/appiliate/{appiliateId}
Authorization: Bearer {access_token} # 선택Path Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
appiliateId | long | 예 | 상품 ID |
Query Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
creator | string | 아니오 | 크리에이터 ID |
utm_source | string | 아니오 | UTM 소스 |
utm_medium | string | 아니오 | UTM 미디엄 |
utm_campaign | string | 아니오 | UTM 캠페인 |
utm_content | string | 아니오 | UTM 콘텐츠 |
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "어필리에이트 상품 상세 조회 성공",
"data": {
"id": 1,
"title": "상품명",
"description": "상품 설명",
"thumbnailImage": "https://...",
"productImages": ["https://..."],
"brandName": "브랜드명",
"originalPrice": 50000,
"salePrice": 45000,
"commissionRate": 10,
"endDate": "2024-02-15",
"productUrl": "https://...",
"creatorLink": "https://...?utm_source=glowb&utm_medium=affiliate&..."
}
}creatorLink는 인증된 크리에이터에게만 발급됩니다.
UTM 링크 생성
크리에이터별 UTM 링크를 생성합니다 (CLID 포함).
HTTP 요청
POST /ai/appiliate/utm-link/{affiliateId}
Authorization: Bearer {access_token}Path Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
affiliateId | long | 예 | 상품 ID |
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "UTM 링크 생성 성공",
"data": "https://example.com/product/1?utm_source=glowb&utm_medium=affiliate&utm_campaign=creator_001&clid=abc123"
}UTM 파라미터
| 파라미터 | 설명 | 예시 |
|---|---|---|
utm_source | 트래픽 소스 | glowb |
utm_medium | 마케팅 채널 | affiliate |
utm_campaign | 캠페인 식별자 | creator_001 |
utm_content | 콘텐츠 구분 | product_review |
clid | 크리에이터 링크 ID | abc123... |