O OneBooks é um fornecedor OAuth 2.0. Dois tipos distintos de aplicação podem pedir acesso à sua empresa: as aplicações de parceiros — sistemas de ponto de venda, ferramentas de parceiros e outros produtos criados na plataforma para programadores — e os clientes de IA como o Claude, o ChatGPT e o OpenClaw, que liga a partir do próprio OneBooks. Ambos passam pelo mesmo ecrã de consentimento, recebem apenas os âmbitos que aprovar e podem ser cortados com um clique.
Autorizar uma aplicação
Seção intitulada “Autorizar uma aplicação”Quando uma aplicação pede para se ligar, o OneBooks abre uma página de consentimento com o nome da aplicação e o acesso que pede (por exemplo Ver faturas, Criar e modificar faturas, Ver relatórios financeiros). Inicie sessão se for preciso, escolha a empresa e selecione Aprovar ou Recusar. O acesso fica ligado a essa empresa; se mudar de empresa ativa mais tarde, é preciso um novo consentimento.
Aprovar um dispositivo
Seção intitulada “Aprovar um dispositivo”Algumas aplicações nativas — um programa de computador ou de ponto de venda sem navegador próprio — mostram um código curto em vez de abrirem a página de consentimento. Vá a app.getonebooks.com/device, introduza o código exatamente como aparece, verifique o nome da aplicação e a empresa, e selecione Aprovar. A aplicação dá por isso em poucos segundos; a página avisa quando a ligação estiver feita e pode fechá-la.
Gerir as aplicações ligadas
Seção intitulada “Gerir as aplicações ligadas”Aplicações → Aplicações lista todas as aplicações que autorizou, com a data em que o acesso foi concedido e a da última utilização.
- Revogar retira o acesso à aplicação de imediato; os seus tokens deixam de funcionar.
- Revogar não elimina nada do que a aplicação já criou — são documentos normais na sua contabilidade.
Selecione um cartão para ver exatamente o que a aplicação pode fazer e quando foi utilizada pela última vez.
As permissões continuam a aplicar-se
Seção intitulada “As permissões continuam a aplicar-se”Uma aplicação ligada nunca pode fazer mais do que o utilizador que a autorizou: os âmbitos são verificados em cada pedido, e a função e as permissões do utilizador também. Os clientes de IA passam ainda pelo circuito das propostas — consulte Ligar o Claude, o ChatGPT e outros agentes de IA.
Criar uma aplicação
Seção intitulada “Criar uma aplicação”Registe-se no portal para programadores em developer.getonebooks.com para obter credenciais OAuth, empresas de teste, âmbitos e a referência da API.