Pandafile · 매주 50GB 무료
앱과 워크플로를 위한 파일 전송 API
Pandafile에는 내 코드, 서버, 노코드 도구에서 대용량 파일을 보낼 수 있는 REST API가 있습니다. 전송을 만들고, 이어 올리기로 파일을 업로드하고, 받는 사람에게 개인 링크를 이메일로 보내고, 누군가 다운로드하면 웹훅으로 알림을 받으세요. API는 Pro와 Team에 포함되며, 웹 앱과 같은 한도가 적용되고, 공개된 OpenAPI 3.1 문서로 설명되어 있습니다. 테스트 키를 쓰면 실제 이메일을 보내거나 저장 공간을 쓰지 않고도 개발하고 테스트할 수 있습니다.
OpenAPI 3.1로 설명된 REST API
모든 엔드포인트는 /api/v1 아래에 있으며 JSON으로 통신합니다. 인증은 Authorization 헤더에 API 키를 Bearer 토큰으로 넣어 처리합니다. 키는 대시보드에서 만들며 한 번만 표시되고, 읽기 전용, 읽기 및 쓰기, 전체 권한 중에서 범위를 정할 수 있어 보고서용 스크립트가 전송을 삭제할 권한을 갖지 않게 할 수 있습니다. API 전체는 /api/v1/openapi.json의 기계 판독 가능한 OpenAPI 3.1 문서로 설명되어 있어 Postman에 불러오거나, 클라이언트를 생성하거나, AI 코딩 어시스턴트에게 건넬 수 있습니다. /developers의 개발자 가이드는 핵심 개념을, /developers/api의 API 레퍼런스는 모든 엔드포인트를 예제와 함께 설명합니다. 모든 응답에는 요청 ID가 붙고, 요청 한도는 RateLimit 헤더로 알려 주며, 목록은 커서 페이지네이션을 쓰고, 오류는 하나의 JSON 형식을 따릅니다.
tus로 이어 올리기
대용량 파일과 불안정한 네트워크는 하나의 긴 HTTP 요청과 잘 맞지 않습니다. 파일을 보내려면 먼저 POST /api/v1/transfers로 전송을 만들고 파일, 제목, 메시지, 그리고 원하면 받는 사람의 이메일 주소를 지정합니다. 이어서 각 파일을 이어 올리기용 공개 프로토콜인 tus로 업로드하므로, 연결이 끊기거나 서버가 다시 시작되어도 처음부터가 아니라 마지막 바이트부터 이어집니다. JavaScript, Python, Go, Java, .NET, Swift 등을 위한 tus 클라이언트가 이미 마련되어 있습니다. 모든 파일이 올라가면 complete를 호출하세요. 그러면 전송이 다운로드 페이지, 받는 사람별 개인 링크, 알림, 만료 기한을 갖춘 일반 Pandafile 링크가 됩니다. 요금제 한도는 브라우저와 같아서, Pro에서는 전송당 최대 1000 GB, 저장 공간 1500 GB입니다.
URL에서 바로 파일 보내기
파일이 이미 다른 곳에 있을 때도 있습니다. CRM 첨부 파일, 렌더 팜 결과물, 다른 서버에 있는 내보내기 파일 같은 경우입니다. POST /api/v1/transfers/from-url에 HTTPS URL을 넘기면 Pandafile이 파일을 가져와 전송을 만들고 완료까지 처리합니다. 요청은 최대 20초 동안 기다립니다. 작은 가져오기는 완료된 상태로 돌아오고, 큰 가져오기는 uploading 상태로 바로 응답한 뒤 백그라운드에서 계속 진행됩니다. 진행 상황은 GET /api/v1/transfers/{id}/import로 확인하거나, 그냥 transfer.ready 웹훅을 기다리면 됩니다. Zapier와 Make 연동도 이 방식으로, 워크플로가 파일을 먼저 내려받지 않고도 파일을 보냅니다.
웹훅과 알림
폴링하는 대신 이벤트를 구독하세요. Pandafile은 전송이 준비되거나 다운로드되거나 만료될 때, 받는 사람이 파일을 승인하거나 수정을 요청할 때, 누군가 내 파일 요청에 업로드할 때, 서명 요청이 완료될 때 내 URL을 호출합니다. 각 전달에는 Pandafile-Signature 헤더에 HMAC-SHA256 서명이 담겨 있어 정말 저희가 보낸 것인지 확인할 수 있고, 전달에 실패하면 1분, 5분, 30분, 2시간, 12시간 후에 다시 시도합니다. 이벤트는 30일 동안 보관되며 GET /api/v1/events로 읽을 수 있습니다. 코드가 전혀 필요 없다면 같은 이벤트를 Slack, Microsoft Teams, Discord에 메시지로 보낼 수도 있습니다.
테스트 키, 안전한 재시도, 그 밖의 자동화
API 키에는 두 가지 모드가 있습니다. 라이브 키는 pf_live_로, 테스트 키는 pf_test_로 시작합니다. 테스트 키로 만든 전송은 이메일을 보내지 않고, 저장 공간이나 사용량에 포함되지 않으며, 24시간만 보관되고, 일반 전송 목록에도 나타나지 않습니다. 그래서 부작용 없이 실제 API를 대상으로 통합 테스트를 실행할 수 있습니다. POST와 PATCH 요청은 Idempotency-Key 헤더를 지원하므로 요청을 재시도해도 전송이 두 번 만들어지지 않습니다. 전송 외에도 받는 사람과 알림, 다운로드 기록, 링크 통계와 승인, 파일 요청, 서명 요청, 브랜딩, 팀 초대를 API로 다룰 수 있습니다. API는 월 $5.99 또는 연 $49.99부터인 Pro와, 월 $14.99 또는 연 $129.99부터인 Team에 포함되어 있습니다. 팀에서는 멤버마다 자신만의 개인 키를 갖습니다.
개발자 가이드 · API 레퍼런스 · OpenAPI 3.1 문서
자주 묻는 질문
Pandafile에 API가 있나요?
네. Pandafile에는 /api/v1 아래에 REST API가 있어 전송 생성, 파일 업로드, 받는 사람·파일 요청·서명 요청 관리, 웹훅 수신을 할 수 있습니다. Pro와 Team 요금제에 포함되어 있습니다.
API 문서는 어디에 있나요?
개발자 가이드는 /developers에, 예제가 포함된 전체 API 레퍼런스는 /developers/api에 있습니다. 기계 판독 가능한 OpenAPI 3.1 문서는 /api/v1/openapi.json에 공개되어 있습니다.
연결이 끊겨도 업로드를 이어 갈 수 있나요?
네. 파일은 이어 올리기용 tus 프로토콜로 업로드되므로, 중단된 업로드는 처음부터 다시 시작하지 않고 멈춘 곳부터 이어집니다.
실제 이메일을 보내지 않고 테스트할 수 있나요?
네. pf_test_로 시작하는 테스트 키를 쓰세요. 테스트 전송은 이메일을 보내지 않고, 저장 공간이나 사용량에 포함되지 않으며, 24시간 후 삭제됩니다.
이미 온라인에 있는 파일을 보낼 수 있나요?
네. POST /api/v1/transfers/from-url이 HTTPS URL에서 파일을 가져와 전송으로 만듭니다. 큰 가져오기는 백그라운드에서 계속되며, 링크가 준비되면 transfer.ready 웹훅이 알려 줍니다.