API:Tokens (Acción)
Esta página es parte de la documentación de la API de acciones de MediaWiki. |
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 |
|
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".