본문으로 건너뛰기

모든 폼 조회 GET ​

내 계정의 모든 폼을 최신순으로 조회해요.

엔드포인트 ​

GET https://api.pocketalert.app/v1/forms

인증 ​

필수

요청에 다음 헤더 중 하나를 포함하세요:

  • Token: <your-api-key> — API 키에서 발급받으세요
  • Authorization: Bearer <jwt-token> — 로그인에서 발급받으세요

요청 ​

헤더 ​

헤더필수설명
Token✅API 키
Authorization✅Bearer <jwt-token>

요청 예시 ​

bash
curl -X GET "https://api.pocketalert.app/v1/forms" \
  -H "Token: your-api-key"
javascript
const response = await fetch('https://api.pocketalert.app/v1/forms', {
  headers: { 'Token': 'your-api-key' }
});

const forms = await response.json();
forms.forEach((form) => console.log(form.name, `https://frms.click/${form.tid}`));
python
import requests

response = requests.get(
    'https://api.pocketalert.app/v1/forms',
    headers={'Token': 'your-api-key'}
)

for form in response.json():
    print(form['name'], f"https://frms.click/{form['tid']}")
php
$forms = Http::withHeaders([
    'Token' => 'your-api-key',
])->get('https://api.pocketalert.app/v1/forms')->json();

foreach ($forms as $form) {
    echo $form['name'].' https://frms.click/'.$form['tid'].PHP_EOL;
}

응답 ​

성공 응답 ​

200 OK

폼의 배열이에요. 폼이 없는 계정은 []를 반환해요.

필드타입설명
tidstring폼 식별자 — 공개 링크는 https://frms.click/{tid}예요
namestring내부 이름으로, 대시보드에 표시돼요
fieldsarray폼의 필드예요 — 폼 생성을 참고하세요
settingsobject제목, 텍스트, 디자인 설정이에요 — 폼 생성을 참고하세요
application_tidstring제출 데이터가 속한 애플리케이션이에요 (없으면 비어 있어요)
device_tidstring대상 기기의 TID, all, 또는 모든 기기를 뜻하는 빈 값이에요
default_levelint | null제출 데이터에 적용되는 우선순위 레벨이에요 (-2..2)
push_titlestring푸시 알림 제목 템플릿이에요 (비어 있으면 Form: {name}이에요)
allowed_originsarray폼 삽입 및 제출을 허용하는 호스트예요 (비어 있으면 제한 없음이에요)
max_responsesint응답 수 상한이에요. 무제한은 0이에요
closes_atstring | null마감 시간이며, UTC 기준 RFC 3339 형식이에요
closedboolean폼이 현재 제출을 받지 않는지 여부예요
is_activeboolean소유자가 설정한 켜기/끄기 스위치예요
submissions_countint지금까지 받은 응답 수예요
last_submission_atstring마지막 응답 시간이며, 계정 시간대 기준이에요
created_atstring생성 날짜이며, 계정 시간대 기준이에요
json
[
  {
    "tid": "vml19aihrga216gt8apc5e3m9",
    "name": "Contact form",
    "fields": [
      { "id": "name", "type": "text", "label": "Name", "placeholder": "Jane Doe", "required": true },
      { "id": "email", "type": "email", "label": "Email", "placeholder": "[email protected]", "required": true }
    ],
    "settings": {
      "title": "Get in touch",
      "top_text": "Leave your details and we will get back to you shortly.",
      "primary_color": "#3f5cad",
      "submit": { "text": "Submit", "color": "", "size": "md" }
    },
    "application_tid": "qm47b9pzxzx7applfd0",
    "device_tid": "",
    "default_level": null,
    "push_title": "New lead: {Name}",
    "allowed_origins": ["example.com"],
    "max_responses": 0,
    "closes_at": null,
    "closed": false,
    "is_active": true,
    "submissions_count": 12,
    "last_submission_at": "23.09.2026 14:05:11",
    "created_at": "20.09.2026 09:12:40"
  }
]

오류 응답 ​

상태설명
401인증 실패 — 토큰이 잘못되었거나 없어요
500폼을 불러오지 못했어요

Pocket Alert 문서