API:Tokens (Acción)

tokens
Gets tokens for data-modifying actions. Este módulo no puede ser utilizado como de generador.
Prefijo
Derechos requeridos	Ninguno
¿Correo sólo?	No
Ayuda generada	Actual
Versión añadida	≥ 1.20

Para el método actual de obtener tokens vía un meta módulo, ve: 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 Puede ser obtenido utilizando acción=tokens. Estos tokens entonces puede ser utilizados en otras peticiones API.

Parámetros

• type: El tipo de token pedido.
  • block
  • delete
  • edit
  • email
  • import
  • move
  • options
  • patrol
  • protect
  • rollback
  • unblock
  • watch
    
    El Central Auth extensión en MediaWiki los servidores añaden los siguientes tokens:
  • deleteglobalaccount
  • setglobalaccountstatus

Ejemplos

Getting an edit token (default behavior)

api.php?action=tokens [Prueba en ApiSandbox]

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

Getting several tokens at once

api.php?action=tokens&type=edit|email|patrol|watch [Prueba en ApiSandbox]

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

Posibles errores

Además de los errores habituales, otros errores pueden ser regresados en el formato siguiente:

<?xml version="1.0"?>
<api>
   <warnings>
      <tokens>Valor no reconocido para el parámetro <var>type</var>: test.</tokens>
   </warnings>
   <tokens/>
</api>

Los errores posibles incluyen:

• Valor no reconocido para el parámetro type: value.
• ⧼apiwarn-tokennotallowed⧽

Fallando en urlencode el token puede resultar en un error token nulo.

Nota importante

Necesitas enviar la cookie obtenida en la fase de inicio de sesión cuando llames a la API con la acción "tokens"; de lo contrario, obtendrá el error críptico "readapidenied".