API 개요
링크, 분석, 도메인, 파트너 운영을 위한 REST API v1: 기본 URL, 키 종류, 스코프, 화이트라벨 모델.
2026년 8월 13일 업데이트
대시보드로 할 수 있는 일은 API로도 모두 할 수 있습니다. 타기팅 규칙과 A/B 테스트 분할이 적용된 링크 생성, 분석 데이터 조회, 도메인 연결, 고객과 요금제 관리까지 가능합니다. API는 곁다리 기능이 아니라 그 자체로 완결된 제품 표면입니다. 대시보드와 API는 같은 코드를 실행하고 같은 제한을 적용합니다.
기본 URL
https://api.linkprofit.com/v1모든 요청은 HTTPS와 JSON을 사용합니다. QR 코드 이미지와 CSV 내보내기를 제외한 응답은 모두 JSON입니다. 항상 최신 상태로 유지되는 대화형 레퍼런스는 /docs/api/reference에 있으며, 모든 요청을 검증하는 것과 동일한 스키마에서 생성됩니다.
두 가지 키 종류
| 키 접두사 | 스코프 | 생성 위치 | 접근 범위 |
|---|---|---|---|
| lp_live_… | 워크스페이스 | 워크스페이스 설정 → API 키 | /links, /analytics, /domains, /workspace, /events, /webhooks |
| lpp_live_… | 파트너 | 파트너 설정 → API 키 | /partner/* 및 /webhooks |
워크스페이스 키는 고객 워크스페이스 한 곳 안에서만 동작합니다. 파트너 키는 고객, 요금제, 도메인, 결제 등 파트너 계정 전반을 관리합니다. 각 키에는 스코프가 부여되어 그 키로 할 수 있는 일이 제한됩니다.
버전 관리
v1은 고정되어 있습니다. 필드는 추가만 될 뿐 이름이 바뀌거나 삭제되지 않습니다.
호환성이 깨지는 변경은 /v2로 출시됩니다. 문서에 명시된 필드를 기준으로 개발하고,
알 수 없는 필드는 무시하십시오.
화이트라벨: 고객에게 API 제공하기
화이트라벨 링크 서비스를 운영한다면 API도 재판매 대상에 포함됩니다.
- 키는 직접 나눠 줍니다. 각 고객은 자체 브랜드가 적용된 대시보드에서 워크스페이스 키를 직접 만듭니다(설정 → API 키). 파트너 키는 절대 공유하지 마십시오.
- 호스트는 공용으로 유지됩니다. v1에서는 모든 API 트래픽이
api.linkprofit.com으로 향하며, 파트너별 맞춤 API 도메인은 아직 제공되지 않습니다. 기본 URL은 문서에 “내 서비스의 API 호스트”라고 적으십시오. 응답에는 LinkProfit 브랜딩이 전혀 담기지 않습니다. - 제한은 요금제를 따릅니다. API 접근 권한은 판매하는 요금제의 기능 플래그
(
api_access)이며, 각 키의 요청 제한은 요금제에서 결정됩니다. API 접근이 없는 요금제를 쓰는 고객은403 plan_restricted를 받습니다.
자체 개발자 문서에 그대로 복사해 적용할 수 있는 페이지는 화이트라벨 가이드에 준비되어 있습니다.