시작하기 / 인증과 권한
시작하기 / 인증과 권한
인증과 권한
콘솔의 설정 › 개발자 › API · Webhook 에서 키를 발급합니다. 키는 발급 직후 한 번만 보이고 다시 볼 수 없습니다. 잃어버리면 폐기하고 새로 발급하세요.
헤더
모든 요청에 Authorization: Bearer psk_… 를 넣습니다. 키는 워크스페이스에 묶여 있어서, 그 키로 만든 문서는 그 워크스페이스의 문서함에 들어가고 그 워크스페이스의 건수를 씁니다.
권한(scope)
| 권한 | 할 수 있는 일 |
|---|---|
read | 문서·서식·주소록·링크·사용량 조회, 완료본 내려받기 |
write | 위에 더해 발송, 취소, 재발송, 서식 생성·삭제, 주소록 편집 |
발급 화면에서 쓰기 권한을 끄면 조회만 되는 키가 나옵니다. 읽기 전용 키로 쓰기 엔드포인트를 부르면 403 이 돌아옵니다. 외부 대시보드처럼 조회만 하는 곳에는 읽기 전용 키를 주세요.
요금제 조건
API · Webhook · MCP 는 베이직 요금제(월 6,900원)부터입니다. 무료로 내려가면 이미 발급한 키도 인증되지 않고 401 이 돌아옵니다. 키를 지우는 게 아니라 잠그는 것이라, 다시 구독하면 같은 키가 그대로 동작합니다.
키 관리
- 키는 여러 개 발급할 수 있습니다. 연동처마다 따로 발급하면 하나만 폐기하기 쉽습니다
- 콘솔 목록에서 각 키의 마지막 사용 시각을 볼 수 있습니다. 안 쓰는 키는 폐기하세요
- 폐기는 즉시 적용됩니다. 진행 중인 요청도 다음 호출부터 401 입니다
더 궁금한 점이 있나요?
콘솔 사용법은 사용자 가이드를 보세요. 연동 중 막히면 hello@lillo.cx 로 요청·응답을 함께 보내 주세요.
인증 확인
bash
curl -i https://api.pindersign.net/v1/documents \
-H "Authorization: Bearer psk_xxxxxxxx"키가 잘못됐을 때
json
HTTP/1.1 401 Unauthorized
{
"message": "인증이 필요합니다.",
"error": "Unauthorized",
"statusCode": 401
}읽기 전용 키로 쓰기
json
HTTP/1.1 403 Forbidden
{
"message": "이 API 키에는 쓰기 권한(write)이 없습니다.",
"error": "Forbidden",
"statusCode": 403
}