接入说明

1. 在控制台创建表单

创建后你会得到 `formId` 和 `manageToken`。浏览器也会自动保存当前表单，方便你继续回到控制台操作。

2. 复制 HTML 片段

<form action="https://138159.xyz/api/forms/FORM_ID/submit" method="post">
  <input type="text" name="name" placeholder="Name" />
  <input type="email" name="email" placeholder="Email" />
  <textarea name="message" placeholder="Message"></textarea>
  <button type="submit">Send</button>
</form>

3. 或者用 fetch 提交

await fetch("https://138159.xyz/api/forms/FORM_ID/submit", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    name: "Ada",
    email: "[email protected]",
    message: "Need a callback"
  })
});

4. 回控制台查看

GET /api/forms/FORM_ID/submissions
Headers:
  x-manage-token: YOUR_MANAGE_TOKEN

默认能力

• 来源域名白名单
• Turnstile 校验
• Webhook 通知
• magic link 登录
• 提交记录和用量统计
• 默认送试用点数，按有效提交扣点

常见报错

• 403：当前来源域名不在白名单
• 400：提交字段为空或 Turnstile 未通过
• 402：点数余额不足，需要先充值
• 404：`formId` 不存在
• 409：slug 已被占用

如果你已经有表单

去“客户登录”，输入表单编号和 owner email，系统会把一次性登录链接发到邮箱，不必依赖当前设备里保存的 token。

如果你在做多表单运营

工作区、请求详情、Checkout、Admin、Launch 这些页面都还在，但它们属于内部流程工具，不需要在第一次接入时全部理解。