API 키, 권한, 테스트 모드

읽는 데 4분 · 2026-11-15 업데이트

간단한 답변

Pro와 Team에서는 대시보드 > 도메인 및 API에서 API 키를 만들어요. 키마다 권한(읽기 전용, 읽기 및 쓰기, 전체 권한)과 모드가 있어요. 라이브 키(pf_live_)는 실제로 작동하고, 테스트 키(pf_test_)는 아무에게도 이메일을 보내지 않으며 전송이 24시간 뒤 만료돼요.

Pandafile API를 쓰면 내 앱, 스크립트, 서버에서 파일을 보내고, 업로드를 받고, 서명을 요청할 수 있어요. API는 Pro와 Team에 포함되며 웹사이트와 같은 한도가 적용돼요. 모든 것은 API 키에서 시작해요.

키 만들기

  1. 로그인하고 대시보드 > 도메인 및 API를 여세요.
  2. API 키에서 키 이름을 정하세요. 예: 웹사이트 업로드.
  3. 키 모드(라이브 또는 테스트)와 키 권한(전체 권한, 읽기 및 쓰기, 읽기 전용)을 고르세요.
  4. 키 만들기를 누르고 바로 키를 복사하세요. 보안을 위해 한 번만 보여 드려요.
  5. 모든 요청에 Authorization: Bearer 뒤에 키를 붙인 헤더로 보내세요.

활성 키는 최대 10개까지 둘 수 있어요. 라이브 키는 pf_live_, 테스트 키는 pf_test_로 시작해요. 개발자 가이드는 pandafile.co/developers, API 레퍼런스는 pandafile.co/developers/api에 있어요.

권한: 키로 할 수 있는 일

  • 읽기 전용: GET 요청만 가능해요. 정보를 조회할 수는 있지만 아무것도 바꿀 수 없어요.
  • 읽기 및 쓰기: 읽기 전용의 모든 기능에 더해 전송, 파일 요청, 서명 요청, 웹훅 구독을 만들고, 바꾸고, 삭제할 수 있어요.
  • 전체 권한: 브랜딩과 팀 초대 같은 계정 설정을 포함해 모든 것을 할 수 있어요.

테스트 모드

  • pf_test_ 키로 만든 전송은 테스트 데이터예요. 추가한 받는 사람을 포함해 누구에게도 이메일이 가지 않아요.
  • 테스트 전송은 만든 지 24시간 뒤 항상 만료되며 연장할 수 없어요.
  • 어떤 한도, 저장 공간, 사용량에도 포함되지 않고, 일반 전송 목록에도 나오지 않아요.
  • 이에 관한 웹훅 이벤트는 livemode가 false이고, Slack, Microsoft Teams, Discord로는 절대 가지 않아요.
  • 일부 작업은 라이브 키로만 할 수 있어요. 테스트 키로 시도하면 API가 test_mode_unsupported 오류로 답해요.

키를 안전하게 지키기

  • 키를 가진 사람은 누구나 내 계정으로 파일을 보낼 수 있어요. 키는 서버에 두고, 웹사이트나 앱의 공개 코드에는 절대 넣지 마세요.
  • 키가 유출됐을 수 있다면 대시보드 > 도메인 및 API에서 폐기하세요. 그 키를 쓰는 앱은 즉시 멈추고, 그 키로 만든 웹훅 구독(예: Zapier나 Make)도 함께 멈춰요.
  • 키마다 요청 한도가 따로 있어요. 모든 응답의 RateLimit 헤더에서 현재 상태를 확인할 수 있어요.
  • 팀에서 API 키는 개인용이에요. 멤버마다 자기 키를 만들어요.
보낼 준비 되셨나요?

계정 없이 전송당 최대 50 GB까지 무료예요.

파일 보내기