API:Delete/de

Diese Seite ist Teil der deutschen Übersetzung der MediaWiki-API-Dokumentation.

Sprache:	English  • Deutsch

MediaWiki-API

• Erste Schritte (en)
• FAQ (en)
• Datenformate (en)
• Fehlermeldungen (en)
• API-Benutzung einschränken (en)
• Authentifizierung
  • Login (en)
  • Logout (en)
• Abfragen (en)
  • Meta-Informationen (en)
  • Eigenschaften (en)
  • Listen (en)
• Vorlagen expandieren und wiedergeben (en)
• Den Seiten-Cache leeren (en)
• Parameter-Informationen (en)
• Bearbeiten (en)
  • Seiten anlegen/ändern (en)
  • Seiten verschieben (en)
  • Rollback (en)
  • Seiten löschen (en)
  • Gelöschte Änderungen wiederherstellen (en)
  • Seiten (ent-)sperren (en)
  • Benutzer (ent-)sperren (en)
  • Seiten (nicht mehr) beobachten (en)
  • E-Mails verschicken (en)
  • Änderungen kontrollieren (en)
  • Artikel importieren (en)
  • Benutzerrechte ändern (en)
  • Bilder hochladen (en)
• MediaWiki-Erweiterungen, welche die API erweitern (en)
• Interne API-Nutzung und Erweiterungen (en)
• Vermischtes (en)
• Implementation (en)
• Bekannte API-Nutzer (en)

MediaWiki version:

1.12

Token

Um eine Seite zu löschen, wird ein Token benötigt. Dies ist der gleiche wie der Edit-Token und derselbe für alle Seiten, er ändert sich allerdings bei jedem Login. Einen Lösch-Token kann folgendermaßen erhalten:

Einen Lösch-Token erhalten

api.php ? action=query & prop=info & intoken=delete & titles=Hauptseite

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <pages>
      <page
        pageid="1"
        ns="0"
        title="Hauptseite"
        touched="2007-09-03T20:32:21Z"
        lastrevid="20"
        counter="20"
        length="470"
        deletetoken="58b54e0bab4a1d3fd3f7653af38e75cb+\" 
      />
    </pages>
  </query>
</api>

Seiten löschen

Seiten werden mit action=delete gelöscht.

Parameter

• title: Zu löschende Seite.
• pageid: Seiten-ID der zu löschenden Seite.
• token: Der in der vorigen Abfrage erhaltene Token. Das abschließende +\ muss als %2B%5C urlencoded sein.
• reason: Grund für die Löschung (optional). Wenn nicht angegeben, wird eine automatisch erzeugte Begründung benutzt.

Beispiel

Beachte: In diesem Beispiel werden alle Parameter der Einfachheit wegen als GET-Anforderung gesendet. Jedoch muss action=delete mit einer POST-Anforderung gesendet werden, GET-Anforderungen liefern einen Fehler zurück.

Löschen der Hauptseite mit einer automatisch erzeugten Begründung

api.php ? action=delete & title=Hauptseite & token=58b54e0bab4a1d3fd3f7653af38e75cb%2B\

<?xml version="1.0" encoding="utf-8"?>
<api>
  <delete 
    title="Hauptseite"
    reason="einziger Bearbeiter: [[Special:Contributions/Benutername|Benutzername]]
  />
</api>

Fehler

Zusätzlich zu den üblichen Fehlern:

• code: notitle
  • info: The title parameter must be set
    • Der Parameter title muss gesetzt werden
• code: notoken
  • info: The token parameter must be set
    • Der Parameter token muss gesetzt werden
• code: permissiondenied
  • info: You don't have permission to delete pages
    • Du hast nicht die notwendigen Nutzerrechte um Seiten zu löschen
      • Auf den meisten Wikis ist Löschen auf Admins beschränkt, andere Wikis können engere Begrenzungen haben
• code: cantdelete
  • info: Couldn't delete “title.” Maybe it was deleted already by someone else
    • „Titel“ kann nicht gelöscht werden. Möglicherweise wurde er bereits von jemand anderem gelöscht.