inlink개발자 센터

빠른 시작

키를 발급받고 첫 호출을 성공시키기까지 3단계입니다. 키 값과 CAMPAIGN_ID만 내 것으로 바꾸면 그대로 동작하는 명령입니다.

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. 인링크에 비즈니스 회원으로 로그인
  2. 개발자 센터 > API 키 이동
  3. “새 키 만들기” 클릭 → 키 이름 입력 → “발급”
  4. 화면에 뜬 키를 즉시 복사해 안전한 곳에 보관

발급 전에 알아둘 것

  • 키 발급은 Pro 플랜 계정만 가능합니다. Pro 는 키를 만드는 본인 계정의 구독으로 확인합니다(키로 부를 때도 같은 계정 기준). 팀원으로 일하고 있고 조직 소유자 계정이 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배씩 늘리는 방식)로 다시 부르세요.

다음 단계