API:Tokens (Acción)

This page is a translated version of the page API:Tokens (action) and the translation is 88% complete.
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)
Resultado
<?xml version="1.0"?>
<api>
  <tokens edittoken="6c82e3a4f17f52ff1e2e4a16b64fed10+\" />
</api>
Getting several tokens at once
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".

API Documentación

Module "tokens" not found.