API:Tokens (Action)

tokens
Gets tokens for data-modifying actions. Dieses Modul kann nicht als Generator benutzt werden!
Präfix
Erforderliche Rechte	Keine
nur Beitrag?	Nein
generierte Hilfe	aktuell
Version hinzugefügt	≥ 1.20

Für die aktuelle Methode zum Erhalt von Tokens über ein Meta-Modul siehe: API:Tokens.

action=tokens was deprecated in MW 1.24 and removed in 1.37. Use action=query&meta=tokens instead. (See API:Tokens .)

Tokens können per action=tokens bezogen werden. Diese Tokens können infolge für andere Schnittstellenabfragen (API) benutzt werden.

Parameter

• type: Der Typ des angefragten Tokens.
  • block
  • delete
  • edit
  • email
  • import
  • move
  • options
  • patrol
  • protect
  • rollback
  • unblock
  • watch
    
    Die Erweiterung Central Auth auf MediaWiki-Servern bringt folgende zusätzliche Tokens:
  • deleteglobalaccount
  • setglobalaccountstatus

Beispiele

Getting an edit token (default behavior)

api.php?action=tokens [In der ApiSandbox ausprobieren]

Ergebnis
<?xml version="1.0"?> <api> <tokens edittoken="6c82e3a4f17f52ff1e2e4a16b64fed10+\" /> </api>

Getting several tokens at once

api.php?action=tokens&type=edit|email|patrol|watch [In der ApiSandbox ausprobieren]

Ergebnis
<?xml version="1.0"?> <api> <tokens edittoken="6c82e3a4f17f52ff1e2e4a16b64fed10+\" emailtoken="6c82e3a4f17f52ff1e2e4a16b64fed10+\" patroltoken="0eaa2666f8c6c0779c43acbdf9703c4a+\" watchtoken="22dff2c0b0c1bef9ad34673b81b91f22+\" /> </api>

Mögliche Fehler

Zusätzlich zu den Standardfehlermeldungen können weitere Fehler mit folgendem Aufbau gemeldet werden:

<?xml version="1.0"?>
<api>
   <warnings>
      <tokens>Unrecognized value for parameter <var>type</var>: test.</tokens>
   </warnings>
   <tokens/>
</api>

Mögliche Fehler enthalten:

• Unrecognized value for parameter type: value.
• ⧼apiwarn-tokennotallowed⧽

Fehlschlagen des Urlencodings des Tokens kann zu einem ungültigen Token-Fehler führen.

Wichtiger Hinweis

Das in der Anmeldephase bezogene Cookie muss bei Anfragen mit action=tokens mitverschickt werden, andernfalls wird der schwer deutbare Fehler "readapidenied" gemeldet.