接入指南
几分钟内上线安全表单
1. 连接 Gmail
登录后连接 Gmail 或 Google Workspace 发件账户,然后创建网站与表单。
2. 连接 AI Agent
让安装了 SendWeb Skill 的 Agent 发起连接。打开它提供的一次性链接,登录并批准指定 Agent。Agent 得到的是可撤销的配置 Token,而不是您的 Gmail 凭据;它可以为您创建网站、固定路由和接入代码。
3. 浏览器表单
<script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script> <script src="https://forms.yai.nz/sdk/v1.js" defer></script> <form method="post" action="https://forms.yai.nz/f/frm_•••" data-sendyai> <input name="name" required> <input name="email" type="email" required> <textarea name="message" required></textarea> <div class="cf-turnstile" data-sitekey="0x4•••" data-action="sendyai_form"></div> <button type="submit">Send</button> <p data-sendyai-status></p> </form>
4. 服务端 API
API 密钥只能存放在服务端环境变量中,绝不能写进浏览器代码。
curl https://forms.yai.nz/v1/forms/frm_•••/submissions \
-H "Authorization: Bearer $SENDWEB_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
--data '{"fields":{"name":"Ana","email":"ana@example.com","message":"Please send a quote."}}'运行规则
- 请求不能自行提供 to、from、cc、bcc 或 subject。
- 访客邮箱可以成为 Reply-To,但绝不会成为 From。
- 附件与任意 HTML 内容都会被拒绝。
- Gmail 临时失败时会返回错误,不会排队保存内容。
- 服务端幂等键会经过哈希处理,并在 24 小时后过期。