フォーム削除 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 | フォームの削除に失敗しました |