Public API

Submeto 계정을 위한 서버 간 관리 API입니다.

Free를 포함한 모든 활성 Submeto 사용자가 이용할 수 있습니다. Public API 액세스는 기본적으로 꺼져 있으며 보안 위험을 검토한 후 Dashboard에서 활성화해야 합니다.

브라우저가 아닌 서버를 위해 설계

Public API는 cron 작업, 백엔드, CI 파이프라인처럼 제어하는 인프라에서 실행되는 자동화를 위한 것입니다. 폼과 필드를 관리하고 제출을 읽고 처리합니다. 웹사이트 방문자의 폼 데이터를 받는 Form Submission API와는 별개입니다. 그 기능이 필요하면 Form Submission API 문서부터 시작하세요.

할 수 있는 일

모든 작업은 API Key의 scope와 해당 키에 부여된 폼에 따라 승인됩니다.

• 폼 관리 — forms:read, forms:create, forms:update, forms:delete scope에 따라 폼을 나열·생성·수정·삭제합니다.
• 필드 정의 — forms:read 및 forms:update scope로 폼의 필드 구성을 읽고 수정합니다.
• 제출 읽기 — submissions:read 및 submissions:mark_read scope로 폼별 제출을 나열하고 읽음으로 표시합니다.
• 파일 액세스 — 제출에 첨부된 파일에 대해 승인된 단기 다운로드 권한을 얻습니다.
• 워크플로 운영 — 초안을 확인·편집하고 버전을 검증·게시하며 테스트 실행, 실행 검토 및 조건부 실패 재시도를 수행합니다.

보안 경계

• API Key는 브라우저나 모바일 앱이 아닌 서버를 인증합니다. HTTPS를 통한 서버 간 런타임만 사용하세요.
• 키에는 선택한 scope가 있으며 선택한 폼에만 부여할 수 있습니다. 부여되지 않은 리소스는 키에 보이지 않습니다.
• 응답에는 비밀 값, 폼 토큰, 통합 구성 및 원본 제출 payload가 포함되지 않습니다.
• 파괴적 작업에는 scope 외에 애플리케이션 수준의 확인이 필요합니다.