inlink

Quick Start

키를 발급받고 첫 호출을 성공시키기까지 3단계입니다. 모든 예제는 실제로 동작하는 명령입니다.

0. 주소가 맞는지 1초 확인 (키 없이)

가짜 키로 한 번 불러 401 이 오는지부터 확인하세요. 주소와 네트워크가 맞는지 1초 만에 알 수 있습니다.

cURL · 2026-08-07 실측
curl -i https://inlink.to/api/v1/campaigns -H "Authorization: Bearer inlink_0000000000000000000000000000000000000000000000000000000000000000"

# → HTTP 401
# {"error":"Invalid or missing API key"}

이 응답(401)이 나오면 주소와 네트워크는 정상입니다. 이제 진짜 키만 있으면 됩니다.

1. API 키 발급

  1. inlink에 비즈니스 회원으로 로그인
  2. 개발자 센터 > API 키 이동
  3. “새 키 생성” 클릭 후 키 이름 입력
  4. 화면에 뜬 키를 즉시 복사해 안전한 곳에 보관

발급 전에 알아둘 것

  • 키 발급은 Pro 플랜 계정만 가능합니다.
  • 계정당 활성 키는 최대 5개입니다.
  • 평문 키는 저장하지 않고 sha256 해시만 보관합니다 — 분실하면 복구할 수 없어 새로 발급해야 합니다.
  • 키는 비밀번호와 같습니다 — 코드에 하드코딩하지 말고 환경변수로 넣으세요.

2. 첫 번째 호출

Base URL은 https://inlink.to/api/v1, 키는 inlink_ 로 시작합니다.

cURL
export INLINK_API_KEY="inlink_1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f809"

# 내 캠페인 목록
curl https://inlink.to/api/v1/campaigns \
  -H "Authorization: Bearer $INLINK_API_KEY"

위 키 값은 형식을 보여주는 예시입니다(실제 키 아님). 성공하면 { "data": [...], "pagination": {...} } 형태가 돌아옵니다.

3. 한 건 자세히 보기

캠페인 상세 — 목록에서 얻은 id 를 그대로 넣습니다.

cURL
curl https://inlink.to/api/v1/campaigns/CAMPAIGN_ID \
  -H "Authorization: Bearer $INLINK_API_KEY"

알아둘 한도

  • 키당 분당 60회 · IP당 분당 300회(60초 고정창).
  • 플랜별 차등 한도·일일 한도는 없습니다.
  • 초과하면 429 — 지수 백오프(재시도 간격을 2배씩 늘리는 방식)로 다시 부르세요.

다음 단계