Forms · 客户使用文档

用户需要准备

准备包含输入框的网页；无需自建提交服务器或额外账号，但 HTML 表单本身需要自己制作。

工作台操作步骤

1. 01在 PicoSvc 创建表单并复制提交 URL。
2. 02将 URL 设为 HTML 表单的 action，并设置 method=POST。
3. 03提交测试数据并查看列表。

调用与集成示例

将店铺网站的姓名／邮箱／留言表单 action 指向生成 URL，在 PicoSvc 查看提交并按需导出 CSV。

<form action="https://YOUR_ISSUED_ENDPOINT/forms/PUBLIC_ID" method="POST">
  <label>Name <input name="name" required></label>
  <label>Email <input name="email" type="email" required></label>
  <label>Message <textarea name="message" required></textarea></label>
  <button type="submit">Send</button>
</form>
<!-- Replace action with the exact endpoint returned by PicoSvc. -->

示例包含占位值；请替换 $BASE_URL、$SESSION_TOKEN 和生成的 URL。不要将令牌或 API 密钥发布到网站或仓库。

普通 HTML 表单提交后通常会显示 202 JSON。如需跳转感谢页面，请通过表单配置 API 设置 successRedirect。不支持 multipart 文件上传。

管理 API 入口

POST /api/picosvc/forms

创建表单名称，将生成 URL 设为现有 HTML 表单 action；提交 JSON 或 URL 编码字段。

提交 URL、保存的姓名／邮箱／正文等记录，以及可选 Webhook 转发。

不支持的功能

不自动生成表单 UI、不支持 multipart 文件上传、也不自动发送邮件通知。

功能比较与资料来源

表单接收与提交管理：提供 HTML 表单接收 URL、提交记录、CSV 与可选 Webhook。

Formspree：文档介绍通过 API 获取表单提交数据。