시작하기 / 핀더싸인 API

핀더싸인 API

콘솔에서 하는 일은 대부분 REST API 로도 할 수 있습니다. 서명 요청을 만들어 보내고, 진행 상태를 보고, 완료본과 감사추적인증서를 내려받습니다. 요청과 응답은 모두 JSON 이고, PDF 는 base64 문자열로 주고받습니다.

기본 정보

항목	값
Base URL	`https://api.pindersign.net/v1`
인증	`Authorization: Bearer psk_…` (워크스페이스 단위 API 키)
형식	요청·응답 `application/json`. 파일 내려받기만 바이너리
문자셋	UTF-8
시간	ISO 8601 (`2026-09-19T13:02:13.227Z`)
요금제	베이직부터. 무료 워크스페이스의 키는 인증되지 않습니다

건수 차감

서명 요청 발송에 성공하면 문서 1건당 잔여 건수 1건이 빠집니다. 콘솔에서 보낸 것과 같은 잔여 건수를 씁니다. 요청을 취소하거나 서명자가 거절하면 1건이 자동으로 돌아옵니다. 건수는 매달 채워지고, 그때 남아 있던 건수는 소멸합니다(이월 없음).

발송 전에 GET /billing/usage 로 남은 건수를 확인하세요. 대량 발송은 필요한 건수가 모자라면 한 건도 보내지 않고 400 으로 끝납니다.

먼저 읽을 것

인증과 권한: API 키 발급, 읽기 전용 키, 요금제 조건
서명 요청 만들기: 가장 많이 쓰는 엔드포인트
웹훅: 완료를 기다리지 않고 알림으로 받기

다음인증과 권한

더 궁금한 점이 있나요?

콘솔 사용법은 사용자 가이드를 보세요. 연동 중 막히면 hello@lillo.cx 로 요청·응답을 함께 보내 주세요.

첫 호출

bash

curl https://api.pindersign.net/v1/billing/usage \
  -H "Authorization: Bearer psk_xxxxxxxx"

응답

json

{
  "plan": "pro",
  "credits": 87,
  "monthlyCredits": 100,
  "creditsRenewAt": "2026-10-19T00:00:00.000Z",
  "grantedFree": 2,
  "grantedPaid": 100,
  "used": 15,
  "expired": 13,
  "subscription": {
    "status": "active",
    "interval": "month",
    "currentPeriodEnd": "2026-10-19T00:00:00.000Z"
  }
}