Dropbox Forms 데이터를 CSV로 내보내는 방법

업데이트된 날짜 Oct 23, 2025

In this article

warning icon

중요: 2025년 9월 30일에 Dropbox Forms 사용이 중단됩니다. 2025년 9월 2일부터는 Forms에서 새 워크플로를 생성할 수 없지만, 9월 30일 마감일까지는 기존 워크플로를 보고 내보낼 수 있습니다.

Dropbox Forms 지원 종료에 대해 자세히 알아보세요.

Dropbox Forms를 사용하여 데이터를 CSV 파일로 다운로드할 수 있습니다. 이 기능은 유료 Dropbox Forms 요금제에서만 사용할 수 있습니다. 

팀 관리자는 최대 25,000개의 작성된 양식에서 데이터를 다운로드할 수 있습니다. 각 행에는 양식의 모든 페이지에서 수신자가 제공한 모든 정보가 포함되어 있습니다.

데이터를 CSV로 내보내는 방법

전송되고 작성된 양식에서만 데이터를 다운로드할 수 있습니다.

Dropbox Forms의 데이터를 CSV로 내보내기:
  1. Dropbox Forms에 로그인합니다. 
  2. 왼쪽 메뉴 표시줄에서 전송됨을 클릭합니다. 
  3. CSV 다운로드를 클릭합니다.
  4. 전송된 양식을 채울 기간을 선택합니다. 
  5. 다운로드하려는 양식 옆에 있는 확인란을 선택합니다. 선택한 각 양식은 별도로 다운로드됩니다. 
  6. 계속하기를 클릭합니다.

데이터는 CSV로 ZIP 파일에 저장됩니다. 선호하는 프로그램을 사용하여 이 정보를 볼 수 있습니다.

highlighter icon

참고: 데이터를 CSV로 다운로드하면 PDF, 감사 내역, 업로드된 첨부 파일은 표시되지 않습니다. 이 정보를 확인하려면 양식을 개별적으로 다운로드해야 합니다. 그러려면 작업에서 다운로드를 클릭합니다.

Dropbox Forms API를 사용하여 데이터를 대량으로 내보내는 방법

Dropbox Forms API를 사용하여 워크플로 데이터를 대량으로 내보낼 수 있습니다. Dropbox Forms API는 Dropbox Forms에서 자동화된 워크플로로 작업할 수 있는 REST API입니다. 워크플로 인스턴스를 생성 및 관리하고, 상태를 확인하고, 워크플로가 완료되면 알림을 받을 수 있습니다. 

요청에 application/x-www-form-urlencoded 또는 application/json을 사용할 수 있으며, 모든 API 응답은 JSON 형식으로 반환됩니다.
 

 

Dropbox Forms API를 설정하는 방법

Dropbox Forms API로 내보내기를 시작하려면 API 키와 기존 워크플로가 필요합니다.

  1. Dropbox Forms 포털에 로그인합니다.
  2. 왼쪽 사이드바에서 API 키를 클릭합니다.
  3. 오른쪽 상단의 새 키를 클릭합니다.
  4. 팀에서 식별할 수 있도록 API 키의 고유한 이름을 입력합니다.
  5. 키를 테스트 요청에 사용할지 실제 요청에 사용할지 선택합니다.
  6. 키가 생성되면 다음을 받습니다.
    • 공개 키 ID
    • 개인 키 값
warning icon

중요: 개인 키 값을 즉시 기록하고 안전한 곳에 보관하세요. 나중에 개인 키 값을 불러올 수는 없지만 언제든 새 키를 생성할 수 있습니다.

Dropbox Forms API는 인증을 위해 API 키와 JSON 웹 토큰(JWT)을 모두 사용합니다. API 키는 단기 JWT를 검색하는 데 사용되며, JWT는 API 호출을 인증하는 데 사용됩니다.
 

대량 내보내기 이용 방법

API 키를 받으면 다음을 수행해야 합니다. 

  1. 모든 후속 호출의 헤더에 JWT를 추가합니다.
Authorization: Bearer <YOUR_JWT>
  • 참고: <YOUR_JWT>를 사용자의 JWT로 바꿉니다. 

2. 터미널에서 다음 명령을 실행하여 워크플로 목록을 가져옵니다. 

curl -s -H "Authorization: Bearer <YOUR_JWT>" \
https://api.helloworks.com/v3/workflows

3. 출력에서 각 workflow_id를 기록합니다. 

4. 다음 명령을 실행하여 선택한 날짜 범위에 대한 CSV 데이터가 포함된 ZIP 파일을 다운로드합니다.

curl -L -H "Authorization: Bearer <YOUR_JWT>" \
"https://api.helloworks.com/v3/workflows/<WORKFLOW_ID>/csv?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD" \
-o workflow_<WORKFLOW_ID>.zip
highlighter icon

참고: URL에서 <WORKFLOW_ID>를 사용자의 ID로, YYYY-MM-DDT00:00:00Z를 시작 및 종료 날짜로 바꿉니다(예: start_date=2020-01-01T00:00:00Z).

6. 다음 명령을 실행하여 CSV를 추출합니다.
unzip -p workflow_<WORKFLOW_ID>.zip "*.csv" > workflow_<WORKFLOW_ID>.csv
highlighter icon

참고

  • 여러 개의 CSV가 있는 경우 모두 추출하여 처리해야 합니다.
  • 한 번에 최대 183일만 다운로드할 수 있습니다. 그 이상의 범위가 필요한 경우 여러 번 호출해야 합니다.

각 인스턴스에 대한 문서를 다운로드하는 방법 

CSV를 다운로드하여 연 후 다음을 수행해야 합니다.

  1. 인스턴스 ID('workflow_instance_id' 또는 'instance_id')가 있는 열을 찾습니다.
  2. 다음 명령을 실행하여 각 인스턴스 ID에 대한 문서가 포함된 ZIP 파일을 다운로드하세요. 
curl -L -H "Authorization: Bearer <YOUR_JWT>" \
https://api.helloworks.com/v3/workflow_instances/<INSTANCE_ID>/documents \
3. ZIP 파일을 압축 해제하여 파일을 확인합니다. 
이 글이 도움이 되셨나요?

문제가 해결되지 않은 이유를 알려주세요.

Dropbox에 알려주셔서 감사합니다!

의견을 보내 주셔서 감사합니다!

커뮤니티 답변

도움을 받을 수 있는 기타 방법