API 문서

Create an API key in your account, then call LinkBit with x-api-key or Authorization: Bearer. Public docs never show your keys.

사용 방법

REST API

모든 요청에 x-api-key 또는 Authorization: Bearer slk_... 를 넣으세요.

x-api-key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY

요청 예제

▸URL 단축 (단일)

짧은 링크 하나를 만듭니다. 맞춤 슬러그는 선택 사항입니다(영문, 숫자, 하이픈, 1자 이상).

curl -X POST https://linkbit.live/api/v1/links \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"destination": "https://example.com/long-url", "slug": "my-link", "utm_source": "newsletter"}'

▸대량 단축 (플랜 한도 100개)

한 요청에 여러 개를 만듭니다. 실패한 항목은 errors에 들어가고, 유효한 항목은 생성됩니다.

curl -X POST https://linkbit.live/api/v1/links/bulk \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"urls": [
    {"destination": "https://example.com/page1"},
    {"destination": "https://example.com/page2", "slug": "my-custom-slug"}
  ]}'

▸링크 목록

이 API 키의 모든 짧은 링크를 최신순으로 반환합니다. shortUrl과 클릭 수를 포함합니다.

curl https://linkbit.live/api/v1/links \
  -H "x-api-key: YOUR_API_KEY"

▸클릭 통계

생성 또는 목록의 id를 사용하세요. 클릭, 순 방문자, 국가, 기기, 유입, 일별을 반환합니다.

curl "https://linkbit.live/api/v1/links/LINK_ID/stats?from=2026-01-01&to=2026-01-31" \
  -H "x-api-key: YOUR_API_KEY"

▸분석 개요

계정 수준 요약: 상위 링크, 일별, 국가, 기기, 유입.

curl https://linkbit.live/api/v1/analytics \
  -H "x-api-key: YOUR_API_KEY"

필드 안내

필드	위치	설명
destination	create / bulk	필수. http(s) URL. 별칭: url
slug	create / bulk	선택. a-z, 0-9, 하이픈. 최소 1자. 공백은 하이픈이 됩니다.
utm_source … utm_content	create / bulk / CSV	Optional. Stored on the destination URL. Existing utm_* query params are not overwritten. Hash fragments are kept.
urls	bulk body	링크 배열. 별칭: links
created / errors	bulk response	성공 행과 항목별 검증 오류(index, message).

인증 오류는 401. 잘못된 입력은 400. 없는 통계 id는 404.