고객에게 API 제공하기

화이트라벨 파트너가 자체 브랜드로 API를 문서화하고 재판매하는 방법: 공용 호스트, 고객 소유 키, 요금제별 접근 제어.

2026년 8월 13일 업데이트

고객도 여러분이 파트너 계정을 자동화하는 것과 똑같은 방식으로 자신의 링크를 자동화할 수 있습니다. 이 페이지는 API를 여러분 제품의 기능으로 만드는 방법을 정리한 안내서이며, 자체 개발자 문서에 맞게 다듬어 쓸 수 있는 문구도 함께 담았습니다.

어떻게 동작하나요

고객이 직접 키를 만듭니다. API 접근이 포함된 요금제를 사용하는 모든 워크스페이스에는 브랜드가 적용된 대시보드에 설정 → API 키 메뉴가 있습니다. 키는 워크스페이스에 귀속됩니다. 여러분의 파트너 키는 전혀 관여하지 않으며, 고객은 자신의 데이터에만 접근할 수 있습니다.
호스트는 공용입니다. 모든 요청은 https://api.linkprofit.com/v1으로 전송됩니다. v1에서는 파트너별 맞춤 API 도메인을 제공하지 않으므로, 이 호스트를 여러분 서비스의 기술 엔드포인트로 문서화하십시오. 응답에는 LinkProfit 브랜딩이 전혀 들어가지 않습니다. 페이로드에 담긴 도메인, 링크, 분석 데이터는 모두 고객의 것입니다.
누구에게 열어줄지는 여러분이 정합니다. API 접근 권한은 여러분이 판매하는 요금제의 api_access 플래그로 결정됩니다. 이 플래그가 없는 요금제의 고객은 403 plan_restricted를 받게 되는데, 상위 요금제를 제안하기 좋은 순간입니다. 요청 제한은 키를 따라가므로 상위 요금제에 더 높은 제한을 적용해 출시할 수 있습니다.

고객을 위한 최소한의 개발자 문서 페이지에는 네 가지가 필요합니다.

키가 있는 위치 — “대시보드의 설정 → API 키에서 발급하며, 키는 한 번만 표시됩니다”.
기본 URL — https://api.linkprofit.com/v1, 인증은 Authorization: Bearer <key>로 합니다.
빠른 시작 — 빠른 시작을 그대로 가져와 예시 도메인을 여러분의 도메인으로 바꾸십시오.
레퍼런스 — 대화형 레퍼런스로 연결하거나 OpenAPI 파일(https://linkprofit.com/openapi.json)을 여러분의 문서 도구에 올리십시오. Scalar, Swagger UI, Redoc, Postman에서 그대로 렌더링됩니다.

고객 워크스페이스는 링크, 도메인, 클릭 임계값 이벤트를 받기 위해 자체 웹훅 엔드포인트를 등록합니다. 구독이나 결제 같은 파트너 수준 이벤트는 여러분의 파트너 엔드포인트에만 남으며 고객에게는 전달되지 않습니다.

키는 워크스페이스 단위입니다. 여러 워크스페이스를 관리하는 대행사 고객은 워크스페이스마다 키를 하나씩 만듭니다.
감사 로그는 API로 이루어진 변경을 해당 키에 귀속시켜 기록하고, 고객은 자신의 대시보드에서 이를 볼 수 있습니다. 지원 문의가 사실에서 출발하게 됩니다.
API가 기록하는 모든 것은 대시보드와 동일한 요금제 할당량을 따릅니다. 고객이 스크립트를 동원해 여러분이 판매한 링크 한도를 넘어설 수는 없습니다.