REST 엔드포인트

Spark! API 엔드포인트 참조

마지막 업데이트: 2026-01-19

Spark! REST API는 제휴 마케터, 주문, 커미션 등에 프로그래밍 방식으로 접근할 수 있게 해요. 모든 엔드포인트는 JSON을 반환해요.

기본 URL

https://api.chargezen.com/spark/v1

제휴 마케터

  • GET /affiliates — 모든 제휴 마케터 조회
  • GET /affiliates/:id — ID로 제휴 마케터 조회
  • POST /affiliates — 새 제휴 마케터 생성
  • PUT /affiliates/:id — 제휴 마케터 업데이트
  • DELETE /affiliates/:id — 제휴 마케터 삭제

주문

  • GET /orders — 매출 기여가 인정된 주문 조회
  • GET /orders/:id — ID로 주문 조회
  • POST /orders/:id/attribute — 주문의 기여를 수동으로 지정

커미션

  • GET /commissions — 모든 커미션 조회
  • GET /commissions/:id — ID로 커미션 조회
  • PUT /commissions/:id/approve — 대기 중인 커미션 승인
  • PUT /commissions/:id/reject — 대기 중인 커미션 거절

지급

  • GET /payouts — 모든 지급 조회
  • GET /payouts/:id — ID로 지급 조회
  • POST /payouts — 수동 지급 생성
  • GET /links — 추적 링크 조회
  • GET /links/:id — ID로 링크 조회
  • POST /links — 추적 링크 생성
  • DELETE /links/:id — 링크 삭제

분석

  • GET /analytics/summary — 성과 요약
  • GET /analytics/affiliates — 제휴 마케터별 지표
  • GET /analytics/products — 제품별 지표
  • GET /analytics/clicks — 클릭 단위 데이터
페이지 나누기

목록 엔드포인트는 쿼리 매개변수 page와 per_page를 통한 페이지 나누기를 지원해요. 기본값은 페이지당 25개이며, 최대 100개예요.

필터링과 정렬

목록 엔드포인트는 다음을 지원해요.

  • ?status=active — 상태별 필터링
  • ?created_after=2024-01-01 — 날짜 필터
  • ?sort=created_at — 정렬 필드
  • ?order=desc — 정렬 방향

다음 단계

이 페이지가 도움이 되었나요?

도움이 더 필요하신가요? 고객 지원 문의