Formular löschen DELETE
Lösche ein Formular dauerhaft. Sein öffentlicher Link funktioniert sofort nicht mehr. Nachrichten, die das Formular bereits erzeugt hat, bleiben erhalten.
Endpunkt
DELETE https://api.pocketalert.app/v1/forms/{tid}Authentifizierung
Erforderlich
Füge einen dieser Header in deine Anfrage ein:
Token: <your-api-key>— Hol ihn dir unter API-SchlüsselAuthorization: Bearer <jwt-token>— Aus Anmelden
Anfrage
Pfadparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
tid | string | ✅ | Formular-Kennung |
Beispielanfrage
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'}
)Antwort
Erfolgreiche Antwort
200 OK
json
{ "data": "success" }Nicht rückgängig machbar
Ein gelöschtes Formular kann nicht wiederhergestellt werden, und sein Link kann nicht neu ausgegeben werden. Um Antworten zu stoppen, ohne das Formular zu verlieren, setze is_active mit Formular aktualisieren auf false.
Fehlerantworten
| Status | Beschreibung |
|---|---|
401 | Nicht autorisiert — Token ungültig oder fehlt |
404 | Formular nicht gefunden oder gehört zu einem anderen Konto |
500 | Formular konnte nicht gelöscht werden |