API:Senhas (ação)

tokens
Gets tokens for data-modifying actions. Este módulo não pode ser utilizado como um $generator.
Prefixo
Permissões requeridas	nenhuma
Só publicação?	Não
Ajuda gerada	Atual
Versão adicionada	≥ 1.20

For the current method of obtaining tokens via a meta module, see: 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 can be obtained using action=tokens. These tokens can then be used in other API requests.

Parâmetros

• type: the type of token requested.
  • block
  • delete
  • edit
  • email
  • import
  • move
  • options
  • patrol
  • protect
  • rollback
  • unblock
  • watch
    
    The Central Auth extension on MediaWiki servers adds the following tokens:
  • deleteglobalaccount
  • setglobalaccountstatus

Exemplos

Getting an edit token (default behavior)

api.php?action=tokens [teste na 'Área de Testes' da API (Sandbox)]

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

Getting several tokens at once

api.php?action=tokens&type=edit|email|patrol|watch [teste na 'Área de Testes' da API (Sandbox)]

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

Possíveis erros

In addition to the usual errors, other errors may be returned in the following format:

<?xml version="1.0"?>
<api>
   <warnings>
      <tokens>Valor não reconhecido para o parâmetro <var>type</var>: test.</tokens>
   </warnings>
   <tokens/>
</api>

Possíveis erros incluem:

• Valor não reconhecido para o parâmetro type: value.
• ⧼apiwarn-tokennotallowed⧽

Failing to urlencode the token can result in an invalid token error.

Nota Importante

You need to send the cookie obtained in the login phase when you call the api with the "tokens" action; otherwise you get the cryptic "readapidenied" error.

API documentation