Os tokens de API permitem que scripts e outros serviços usem a API da RedirHub em seu nome. Cada token funciona para um workspace e atua com a sua função nele, então um token pode fazer o que você pode fazer nesse workspace. Os tokens de API estão disponíveis em todos os planos.
Passo 1: Abrir tokens de API#
Abra as definições da sua conta e clique em Tokens de API. A lista mostra o nome de cada token, o workspace, quando foi usado pela última vez e quando expira.
Passo 2: Criar um token#
- Clique em Criar token.
- Dê-lhe um nome que você reconheça, como o serviço que o utilizará.
- Escolha o workspace para o qual ele funciona.
- Escolha quando ele expira: sem expiração, 30, 60, 90 ou 180 dias, ou 1 ano.
Passo 3: Copiar o token#
O token é mostrado na íntegra apenas uma vez, logo após você criá-lo. Clique em Copiar token e guarde-o em algum lugar seguro, como um gerenciador de senhas ou o cofre de segredos do seu serviço. Envie-o com cada pedido no cabeçalho Authorization: Bearer <token>.
A new token is shown in full only once. Copy it right away.
Trate um token como uma senha
Qualquer pessoa com o token pode usar a API com a sua função nesse workspace. Nunca o compartilhe em chat, e-mail ou código público.
Etapa 4: Revogue os tokens de que você não precisa mais#
Clique em Revogar ao lado de um token para fazer com que ele pare de funcionar, por exemplo quando um serviço é descontinuado ou um token pode ter sido vazado. Tokens expirados são marcados na lista e podem ser excluídos.
É bom saber#
- Se você perder um token, crie um novo e revogue o antigo. Um token não pode ser exibido novamente.
- Prefira uma data de expiração. Um token que nunca expira é sinalizado na lista.
- Os endpoints, exemplos e a URL base estão na referência da API.
- Assistentes de IA não precisam de um token: eles se conectam ao servidor MCP da RedirHub em https://mcp.redirhub.com com um login.
Perguntas frequentes
Não. Um token é exibido por completo apenas uma vez. Se você o perder, crie um novo token e revogue o antigo.
Um token funciona para um workspace e age com sua função nele. Um token de Visualizador só pode ler; um token de Editor também pode alterar links, códigos QR e domínios.
Você escolhe ao criar o token: sem expiração, 30, 60, 90 ou 180 dias, ou 1 ano.
A referência da API em /docs lista todos os endpoints com exemplos.