Centro de suporte da Workiva

Na Workiva, gerar um token de acesso (especificamente um token de portador OAuth2) é um processo de duas etapas: primeiro você cria uma API Grant para obter credenciais e, em seguida, usa essas credenciais para solicitar o token real.

1. Você deve criar uma concessão de API

Importante: Você precisa ser o proprietário do Workspace para realizar esta etapa.

Para obter um Client ID & Secret (ID e segredo do cliente):

1. Clique no ícone do seu perfil no canto superior direito da página do Workiva e, em seguida, selecione “Configurações do espaço de trabalho ”.
   
2. Selecione a guia “Segurança” e, em seguida, clique em “Criar autorização de API ”.
   
3. Na página “Atualizar concessão ”, preencha os seguintes campos:
   
   1. Insira o nome do cliente e o nome de usuário do Workiva em nome do qual a autorização atuará.
   2. Selecione “Credenciais de cliente OAuth2” como tipo de cliente .
   3. Selecione os escopos ( permissões) necessários para os pontos de extremidade da API que você pretende usar.
   4. Defina a data de validade .
   5. A menos que seja especificamente exigido pela sua organização, você pode ignorar o campo “Lista de endereços IP permitidos ”.
   6. Clique em “Adicionar subsídio ”.

Importante: Copie o ID do cliente e o segredo do cliente imediatamente, pois o segredo não será exibido novamente.

2. Recuperar o token do portador

Depois de obter suas credenciais, você deve trocá-las por um token de acesso de curta duração, enviando uma solicitação POST ao serviço IAM da Workiva.

• Endpoint: https://api.app.wdesk.com (esse é o padrão para os EUA; outras regiões têm endpoints diferentes ).
• Tipo de conteúdo: Defina Content-Type como application/json .

• 

• Cabeçalhos: Adicionar X-Version : 01/01/2026

• 

• Valores do formulário:
  • grant_type : client_credentials
  • client_id :[Your Client ID]
  • client_secret :[Your Client Secret]
  • Âmbito : Correntes

• 

• Validade: Os tokens ao portador da Workiva geralmente têm validade de 10 minutos. Você deve atualizá-los periodicamente para processos de longa duração.

Tokens SEC EDGAR Next

Se você estiver gerando tokens especificamente para o registro na SEC (EDGAR Next) , eles são diferentes dos tokens padrão da API:

• Esses tokens (Token da API do Declarante e Token do Usuário) são criados no painel de gerenciamento de declarantes do EDGAR da SEC.
• Uma vez obtidos, você pode gerenciá-los na Workiva em SEC Reporting > Manage EDGAR Next Tokens.