用自己的介面填寫 OpenDashboard 表單

curl --fail-with-body "$OPENDASHBOARD_BASE_URL/api/apps/v1/forms/$FORM_ID" \
  -H "Authorization: Bearer $OPENDASHBOARD_TEST_KEY"

{
  "id": "evt_demo_form_ui",
  "title": "Synthetic workshop signup",
  "description": "Only synthetic data is used in this example.",
  "test": true,
  "created_at": "2026-01-01T00:00:00.000Z",
  "questions": [
    { "key": "program", "title": "課程", "type": "short_text", "required": true, "personal": false },
    { "key": "session", "title": "場次", "type": "dropdown", "options": ["Demo A", "Demo B"], "required": true, "personal": false },
    { "key": "interest", "title": "興趣程度", "type": "number", "min": 0, "max": 5, "integer": true, "unit": "", "required": true, "personal": false },
    {
      "key": "participants", "title": "參加者", "type": "repeating_group",
      "min": 1, "max": 4, "required": false, "personal": false,
      "fields": [
        { "key": "participant_ref", "label": "匿名參加者編號", "type": "text", "required": true, "personal": false },
        { "key": "category", "label": "類別", "type": "single_choice", "options": ["Demo beginner", "Demo advanced"], "required": true, "personal": false }
      ]
    }
  ]
}

curl --fail-with-body "$OPENDASHBOARD_BASE_URL/api/apps/v1/forms" \
  -H "Authorization: Bearer $OPENDASHBOARD_TEST_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @custom-ui-form.json

{
  "respondent": "demo-contact-ui",
  "answers": {
    "program": "Synthetic workshop",
    "session": "Demo A",
    "interest": 0,
    "preferred_date": "2026-10-15",
    "topics": ["Demo X", "Demo Y"],
    "participants": [
      { "participant_ref": "demo-person-a", "category": "Demo beginner" },
      { "participant_ref": "demo-person-b", "category": "Demo advanced" }
    ],
    "notes": "Synthetic example only.",
    "portal_source": "demo-portal"
  },
  "submitted_at": "2026-01-01T00:00:00Z",
  "replace": true,
  "expected_version": 0
}

curl --fail-with-body "$OPENDASHBOARD_BASE_URL/api/apps/v1/forms/$FORM_ID/responses" \
  -H "Authorization: Bearer $OPENDASHBOARD_TEST_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @custom-ui-response.json

async function sendMyAnswers({ answers, version, submittedAt, csrfToken }) {
  const response = await fetch('/api/my-form', {
    method: 'POST',
    credentials: 'same-origin',
    headers: {
      'Content-Type': 'application/json',
      'X-CSRF-Token': csrfToken
    },
    body: JSON.stringify({
      answers,
      expected_version: version,
      submitted_at: submittedAt
    })
  });
  const body = await response.json();
  if (!response.ok) {
    return { saved: false, status: response.status, error: body.error,
      fields: body.fields || {}, message: body.message };
  }
  return { saved: true, id: body.id, version: body.version };
}

// Only run on the website server after access.respondent has been authorized.
const response = await fetch(
  process.env.OPENDASHBOARD_BASE_URL + '/api/apps/v1/forms/' +
  encodeURIComponent(process.env.OPENDASHBOARD_FORM_ID) +
  '/responses?respondent=' + encodeURIComponent(access.respondent),
  { headers: { Authorization: 'Bearer ' + process.env.OPENDASHBOARD_APP_KEY } }
);
if (!response.ok) throw new Error('Unable to read the current response');
const payload = await response.json();
const own = payload.responses.find(item => item.respondent === access.respondent);
// Filter hidden/application-owned values before returning permitted answers.
const currentVersion = own ? own.version : 0;

{
  "ok": false,
  "error": "invalid_answers",
  "message": "The response was not saved. Fix these and send it again.",
  "fields": {
    "participants.0.category": "Unknown choice."
  }
}

{
  "respondent": "demo-contact-ui",
  "division": "demo",
  "answers": { "team_name": "Synthetic team" },
  "members": [
    { "alias": "demo-person-a" },
    { "alias": "demo-person-b" }
  ]
}

{
  "answers": { "work": "Synthetic proposal text." },
  "revision": 0
}