🔌 API 개요

FINGERPUSH.LINK REST API의 인증 방식, 공통 규칙, 에러 처리 등 모든 API에 공통으로 적용되는 내용을 안내합니다.

베이스 URL

모든 API 요청의 기본 주소: https://fpl-stage-console.kissoft.biz

API 종류

FINGERPUSH.LINK는 용도와 인증 방식에 따라 4가지 API 계층을 제공합니다.

인증 방식

Service API 인증

콘솔 > 개발자 > API 키 관리에서 발급받은 API Key를 X-API-KEY 헤더에 전달합니다.

curl -X POST https://fpl-stage-console.kissoft.biz/api/v1/service/urls \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your-api-key-here" \
  -d '{"url": "https://example.com/landing"}'

App SDK API 인증

콘솔 > 모바일 앱 관리에서 앱을 등록하면 발급되는 App ID와 Mobile App API Key를 헤더에 전달합니다. 자세한 연동 방법은 App SDK 연동 가이드 ↗를 참고하세요.

curl -X GET "https://fpl-stage-console.kissoft.biz/api/v1/sdk/mobile/deeplink/match?token=abc123" \
  -H "X-App-ID: your-app-id" \
  -H "X-Mobile-App-API-Key: your-mobile-app-api-key"

Web SDK API

Web SDK API는 별도 인증이 필요하지 않습니다. SDK 초기화 시 App ID만 설정하면 됩니다.

공통 요청/응답 규칙

요청 형식

성공 응답

단건 조회·생성·수정은 JSON 객체, 목록 조회는 페이징 래퍼로 응답합니다.

{
  "id": 123,
  "shortUrl": "https://fpl-stage-console.kissoft.biz/abc123",
  "originalUrl": "https://example.com/landing",
  "clickCount": 0,
  "createdAt": "2026-01-15T14:30:00"
}

{
  "content": [ ... ],
  "totalElements": 142,
  "totalPages": 8,
  "number": 0,
  "size": 20
}

에러 응답

에러 발생 시 HTTP 상태 코드와 함께 다음 형식의 JSON이 반환됩니다.

{
  "status": 400,
  "error": "Bad Request",
  "message": "URL은 필수 입력값입니다.",
  "timestamp": "2026-01-15T14:30:00"
}

자세한 에러 코드 목록은 에러 코드 레퍼런스를 참고하세요.

HTTP 상태 코드

Rate Limiting

API 남용을 방지하기 위해 호출 횟수 제한이 적용됩니다.

한도 초과 시 429 Too Many Requests 응답이 반환됩니다. 현재 사용량은 콘솔 > 개발자 > API 호출 한도에서 확인할 수 있습니다.

콘솔 개발자 메뉴

API 키 발급, 웹훅 설정, 사용량 모니터링 등 개발에 필요한 기능은 콘솔의 개발자 메뉴에서 이용할 수 있습니다.

API 문서 가이드

목적에 맞는 문서를 선택하세요.