GET /open-api/v1/forms

curl -X GET "https://api.walla.my/open-api/v1/forms" \
  -H "X-WALLA-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": [
    {
      "workspaceId": "workspace_123",
      "workspaceName": "마케팅 팀",
      "forms": [
        {
          "form": {
            "id": "form_abc",
            "workspaceId": "workspace_123",
            "title": "고객 만족도 설문조사",
            "description": "분기별 고객 피드백 폼",
            "badge": "2024년 1분기",
            "teamId": "team_456",
            "creator": "user_789",
            "lastEditedBy": "user_012",
            "isDeleted": false,
            "createdAt": "2024-01-15T10:30:00Z",
            "updatedAt": "2024-01-20T14:45:00Z"
          },
          "formSettings": {
            // 폼 구성 설정
          },
          "analytics": {
            "submissions": 150
          }
        }
      ]
    }
  ]
}

GET /open-api/v1/forms/{formId}

curl -X GET "https://api.walla.my/open-api/v1/forms/form_abc" \
  -H "X-WALLA-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": {
    "id": "form_abc",
    "title": "고객 만족도 설문조사",
    "description": "분기별 고객 피드백 폼",
    "badge": "2024년 1분기",
    "teamId": "team_456",
    "workspaceId": "workspace_123",
    "creator": "user_789",
    "lastEditedBy": "user_012",
    "isDeleted": false,
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-20T14:45:00Z"
  }
}

GET /open-api/v1/forms/{formId}/fields

curl -X GET "https://api.walla.my/open-api/v1/forms/form_abc/fields" \
  -H "X-WALLA-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": {
    "fields": [
      {
        "id": "field_abc123",
        "label": "이름이 무엇인가요?",
        "fieldType": "SHORT_TEXT",
        "outputType": "string"
      },
      {
        "id": "field_xyz789",
        "label": "선호 사항을 선택하세요",
        "fieldType": "CHECKBOX",
        "outputType": "array"
      },
      {
        "id": "field_def456",
        "label": "주소",
        "fieldType": "ADDRESS",
        "outputType": "object"
      }
    ]
  }
}

GET /open-api/v1/forms/{formId}/fields/{fieldId}

curl -X GET "https://api.walla.my/open-api/v1/forms/form_abc/fields/field_abc123" \
  -H "X-WALLA-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": {
    "id": "field_abc123",
    "publishedFormId": "form_abc",
    "label": "이메일 주소가 무엇인가요?",
    "fieldType": "EMAIL",
    "outputSchema": {
      "type": "string",
      "format": "email"
    },
    "properties": {
      "placeholder": "you@example.com",
      "required": true
    },
    "validations": {
      "required": true,
      "email": true
    },
    "validationErrorMessage": {
      "required": "이메일은 필수입니다",
      "email": "유효한 이메일 주소를 입력하세요"
    },
    "branches": [
      {
        "condition": {
          "field": "field_abc123",
          "operator": "contains",
          "value": "@company.com"
        },
        "action": {
          "type": "show",
          "targetField": "field_xyz789"
        }
      }
    ],
    "isResponseMasked": false,
    "responseMaskOptions": null
  }
}

GET /open-api/v1/forms/{formId}/fields/{fieldId}/description

curl -X GET "https://api.walla.my/open-api/v1/forms/form_abc/fields/field_abc123/description" \
  -H "X-WALLA-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": {
    "id": "field_abc123",
    "publishedFormId": "form_abc",
    "publishedFormFieldId": "published_field_123",
    "html": "<p>연락 가능한 유효한 이메일 주소를 입력해주세요.</p>",
    "tiptapType": "doc"
  }
}

interface Form {
  id: string;
  title: string;
  description: string;
  badge: string;
  teamId: string;
  workspaceId: string;
  creator: string;
  lastEditedBy: string;
  isDeleted: boolean;
  createdAt: string;
  updatedAt: string;
}

async function getAllForms(): Promise<any[]> {
  const response = await fetch('https://api.walla.my/open-api/v1/forms', {
    method: 'GET',
    headers: {
      'X-WALLA-API-KEY': process.env.WALLA_API_KEY!,
      'Content-Type': 'application/json'
    }
  });

  if (!response.ok) {
    throw new Error(`HTTP 오류! 상태: ${response.status}`);
  }

  const data = await response.json();
  return data.data;
}

async function getFormById(formId: string): Promise<Form> {
  const response = await fetch(
    `https://api.walla.my/open-api/v1/forms/${formId}`,
    {
      method: 'GET',
      headers: {
        'X-WALLA-API-KEY': process.env.WALLA_API_KEY!,
        'Content-Type': 'application/json'
      }
    }
  );

  if (!response.ok) {
    throw new Error(`HTTP 오류! 상태: ${response.status}`);
  }

  const data = await response.json();
  return data.data;
}

// 활성(삭제되지 않은) 폼 모두 가져오기
async function getActiveForms(): Promise<Form[]> {
  const workspaces = await getAllForms();
  const activeForms: Form[] = [];

  workspaces.forEach(workspace => {
    workspace.forms.forEach(formWrapper => {
      if (!formWrapper.form.isDeleted) {
        activeForms.push(formWrapper.form);
      }
    });
  });

  return activeForms;
}

import requests
import os
from typing import List, Dict, Any

class WallaFormsAPI:
    def __init__(self, api_key: str):
        self.api_key = api_key
        self.base_url = "https://api.walla.my/open-api/v1"
        self.headers = {
            "X-WALLA-API-KEY": api_key,
            "Content-Type": "application/json"
        }

    def get_all_forms(self) -> List[Dict[str, Any]]:
        """모든 워크스페이스의 모든 폼 가져오기"""
        url = f"{self.base_url}/forms"
        response = requests.get(url, headers=self.headers)
        response.raise_for_status()
        return response.json()["data"]

    def get_form_by_id(self, form_id: str) -> Dict[str, Any]:
        """ID로 특정 폼 가져오기"""
        url = f"{self.base_url}/forms/{form_id}"
        response = requests.get(url, headers=self.headers)
        response.raise_for_status()
        return response.json()["data"]

    def get_active_forms(self) -> List[Dict[str, Any]]:
        """삭제되지 않은 모든 폼 가져오기"""
        workspaces = self.get_all_forms()
        active_forms = []

        for workspace in workspaces:
            for form_wrapper in workspace["forms"]:
                if not form_wrapper["form"]["isDeleted"]:
                    active_forms.append(form_wrapper["form"])

        return active_forms

# 사용법
api = WallaFormsAPI(os.getenv("WALLA_API_KEY"))
forms = api.get_all_forms()
specific_form = api.get_form_by_id("form_abc")

const workspaces = await getAllForms();
const activeForms = workspaces.flatMap(ws =>
  ws.forms
    .filter(f => !f.form.isDeleted)
    .map(f => f.form)
);

const workspaces = await getAllForms();
const targetWorkspace = workspaces.find(ws => ws.workspaceId === 'workspace_123');
const forms = targetWorkspace?.forms || [];

const workspaces = await getAllForms();
workspaces.forEach(ws => {
  ws.forms.forEach(formWrapper => {
    console.log(`${formWrapper.form.title}: ${formWrapper.analytics.submissions}건의 제출`);
  });
});