# 공개 폼 조회 (GET)

방문자의 브라우저가 폼을 읽는 방식 그대로, 라이브 폼의 필드와 디자인을 가져옵니다. 비공개 정보는 포함되지 않습니다. **인증 불필요**: 폼 페이지 자체가 호출하는 엔드포인트입니다.

## 엔드포인트

```
GET https://api.pocketalert.app/v1/forms/{tid}
```

## 인증

> **Tip: 인증 불필요**
>
> 이 엔드포인트는 공개되어 있습니다. 푸시 제목, 라우팅, 응답 카운터 등 소유자만 볼 수 있는 정보는 반환하지 않습니다.

## 요청

### 경로 매개변수

| 매개변수 | 타입 | 필수 | 설명 |
|-----------|------|:--------:|-------------|
| `tid` | string | ✅ | 폼 식별자. `https://frms.click/{tid}`에 나오는 것과 같은 값입니다 |

### 요청 예시

**cURL**

```bash
curl -X GET "https://api.pocketalert.app/v1/forms/vml19aihrga216gt8apc5e3m9"
```

**JavaScript**

```javascript
const form = await fetch('https://api.pocketalert.app/v1/forms/vml19aihrga216gt8apc5e3m9')
  .then((response) => response.json());

if (form.closed) {
  console.log(form.settings.closed_message);
} else {
  console.log(form.settings.title, form.fields.length, 'fields');
}
```

**Python**

```python
import requests

form = requests.get('https://api.pocketalert.app/v1/forms/vml19aihrga216gt8apc5e3m9').json()

print(form['settings']['title'], len(form['fields']), 'fields')
```

## 응답

### 성공 응답

> **Tip: 200 OK**
>
> 마감된 폼도 `200`으로 응답하며, `closed: true`와 빈 `fields` 배열을 반환합니다. 페이지는 이 값을 보고 입력란 대신 `closed_message`를 표시합니다.

| 필드 | 타입 | 설명 |
|-------|------|-------------|
| `tid` | string | 폼 식별자 |
| `closed` | boolean | 폼이 꺼져 있거나, 마감 시간이 지났거나, 응답 가능 수를 모두 채웠을 때 `true` |
| `fields` | array | 렌더링할 필드. 자세한 내용은 [폼 생성](https://info.pocketalert.app/api/forms/create.md#fields)을 참고하세요. `closed`가 `true`이면 비어 있습니다 |
| `settings` | object | 제목, 텍스트, 디자인. 자세한 내용은 [폼 생성](https://info.pocketalert.app/api/forms/create.md#settings)을 참고하세요 |
| `allowed_origins` | array | 폼 삽입을 허용하는 호스트. 비어 있으면 모든 곳에서 삽입할 수 있습니다 |

```json
{
  "tid": "vml19aihrga216gt8apc5e3m9",
  "closed": false,
  "fields": [
    { "id": "name", "type": "text", "label": "Name", "placeholder": "Jane Doe", "required": true },
    { "id": "email", "type": "email", "label": "Email", "placeholder": "jane@example.com", "required": true },
    { "id": "src", "type": "hidden", "label": "Source", "param": "utm_source" }
  ],
  "settings": {
    "title": "Get in touch",
    "top_text": "We reply within one business day.",
    "success_message": "Thanks! Your response has been sent.",
    "closed_message": "This form is no longer accepting responses.",
    "background_color": "#f5f5f4",
    "card_color": "#ffffff",
    "text_color": "#1c1917",
    "primary_color": "#3f5cad",
    "font_family": "Inter",
    "font_size": 16,
    "font_weight": 400,
    "border_radius": 10,
    "hide_branding": false,
    "submit": { "text": "Submit", "color": "", "size": "md" }
  },
  "allowed_origins": []
}
```

> **Info: 숨김 필드**
>
> `hidden` 타입의 필드는 렌더링되지 않습니다. 값은 페이지 URL에서 가져옵니다. 예를 들어 `?utm_source=newsletter`는 `param`이 `utm_source`인 필드를 채우며, 이 값은 제출 시 함께 전송됩니다.

### 오류 응답

| 상태 | 설명 |
|:------:|-------------|
| `404` | 폼을 찾을 수 없음 |
