INSTALL
설치
패키지 관리자로 바로 받습니다.
# JavaScript / TypeScript
npm install @linkhub/sdk
# Python
pip install linkhub
# Java (Gradle)
implementation "com.linkhub:sdk:3.4.0"
# 첫 호출
import { LinkHub } from "@linkhub/sdk";
const lh = new LinkHub({ clientId, clientSecret });
const me = await lh.users.me();
console.log(me.nickname);
npm install @linkhub/sdk
# Python
pip install linkhub
# Java (Gradle)
implementation "com.linkhub:sdk:3.4.0"
# 첫 호출
import { LinkHub } from "@linkhub/sdk";
const lh = new LinkHub({ clientId, clientSecret });
const me = await lh.users.me();
console.log(me.nickname);
SDK 는 토큰 만료를 스스로 감지해 갱신하고, 429 응답을 만나면 Retry-After 를 읽어 자동으로 기다립니다. 직접 구현하면 자주 빠뜨리는 부분이라 기본 동작으로 넣었습니다. 원하지 않으면 옵션으로 끌 수 있습니다.
SUPPORT MATRIX
지원 언어와 정책
공식 지원은 6개 언어입니다.
| 언어 | 최신 버전 | 최소 런타임 | 지원 종료 예정 |
|---|---|---|---|
| JavaScript / TypeScript | 3.4.0 | Node 18 이상 | — |
| Python | 3.4.0 | Python 3.9 이상 | — |
| Java | 3.4.0 | JDK 17 이상 | — |
| Kotlin | 3.2.1 | JDK 17 이상 | — |
| Swift | 2.9.0 | iOS 15 이상 | — |
| PHP | 2.7.3 | PHP 8.1 이상 | 2027년 3월 |
| Go (커뮤니티) | 1.8.0 | Go 1.21 이상 | 공식 지원 아님 |
- 버전 규칙 : 유의적 버전(SemVer) · 주 버전이 오를 때만 호환성이 깨집니다
- 보안 패치 : 직전 주 버전까지 24개월 제공
- 갱신 주기 : 분기 1회 정기 · 보안 건은 수시
- 지원 종료 : 최소 12개월 전 공지 · 마이그레이션 문서 동시 제공
- 커뮤니티 SDK : 저장소는 소개하지만 장애 대응 대상은 아닙니다
DOCS
문서 구성
읽는 목적에 따라 네 갈래로 나눴습니다.
빠른 시작
10분 안에 첫 응답을 받아 보는 것이 목표입니다. 복사해서 그대로 실행되는 코드만 싣습니다.
가이드
결제 연동, 로그인 연동처럼 «하려는 일» 단위로 묶은 문서입니다. 실패 처리와 취소 흐름까지 포함합니다.
레퍼런스
엔드포인트·필드·오류 코드를 빠짐없이 적은 사전입니다. API 명세에서 자동 생성해 문서와 실제 동작이 어긋나지 않습니다.
예제 저장소
동작하는 프로젝트를 통째로 공개합니다. 매일 새벽 자동 실행해 깨진 예제를 걸러냅니다.
문서에서 잘못된 곳을 발견하면 각 문서 하단의 「이 문서가 틀렸습니다」 버튼으로 바로 알려 주실 수 있습니다. 2025년 이 경로로 들어온 제보는 418건이었고, 평균 4.1일 안에 반영했습니다.
링크허브의 기술을 먼저 써 보세요
Open API 신청부터 기업용 도입 상담까지 한 곳에서 진행됩니다.