删除表单 DELETE
永久删除表单。其公开链接会立即失效。表单已产生的消息会保留。
接口地址
DELETE https://api.pocketalert.app/v1/forms/{tid}身份验证
请求
路径参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
tid | string | ✅ | 表单标识符 |
请求示例
bash
curl -X DELETE "https://api.pocketalert.app/v1/forms/vml19aihrga216gt8apc5e3m9" \
-H "Token: your-api-key"javascript
await fetch('https://api.pocketalert.app/v1/forms/vml19aihrga216gt8apc5e3m9', {
method: 'DELETE',
headers: { 'Token': 'your-api-key' }
});python
import requests
requests.delete(
'https://api.pocketalert.app/v1/forms/vml19aihrga216gt8apc5e3m9',
headers={'Token': 'your-api-key'}
)响应
成功响应
200 OK
json
{ "data": "success" }不可撤销
已删除的表单无法恢复,其链接也无法重新生成。如果只想停止接收响应而保留表单,请使用 更新表单 将 is_active 设为 false。
错误响应
| 状态码 | 描述 |
|---|---|
401 | 未授权 — 令牌无效或缺失 |
404 | 表单不存在,或属于其他账户 |
500 | 删除表单失败 |