Crie aplicações para as empresas que usam o OneBooks
Uma API OAuth e MCP, páginas incorporadas diretamente no OneBooks, dados de aplicação sobre registos reais, e funções alojadas — chegue a todas as empresas OneBooks através de uma única ficha revista no Marketplace.
Quatro formas de ampliar o OneBooks
API OAuth e webhooks
Uma API REST OAuth 2.0 com âmbitos sobre faturas, pagamentos, clientes, relatórios e muito mais, e ainda MCP para agentes de IA. Receba mais de 40 eventos por webhook ou através da API de eventos — com escritas idempotentes, versões datadas e documentação de referência completa.
Aplicações dentro do OneBooks
As suas próprias páginas dentro do OneBooks, além de ações e cartões em 15 locais — o painel e sete tipos de registo, das faturas às devoluções de compra — numa moldura isolada, autenticada com tokens de sessão de curta duração.
Dados de aplicação nos registos
Guarde os seus próprios campos tipados em 12 tipos de registo — clientes, faturas, artigos e muito mais — visíveis para o comerciante diretamente no registo, onde ele já trabalha.
Funções alojadas
Execute o seu código com os eventos, num ambiente isolado na infraestrutura do OneBooks. Só alcança os destinos que declarar — sem servidor nenhum para gerir em automações simples.
Da página incorporada aos dados contabilísticos
O App Bridge entrega à sua página incorporada um token de sessão de curta duração. O seu servidor troca-o por um token de acesso — a partir daí, é uma chamada normal à API. Sem redirecionamento e sem SDK obrigatório.
curl -X POST https://api.getonebooks.com/oauth/token \
-u "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" \
-d grant_type=urn:ietf:params:oauth:grant-type:token-exchange \
-d subject_token=SESSION_TOKEN \
-d subject_token_type=urn:ietf:params:oauth:token-type:jwtcurl https://api.getonebooks.com/invoices \
-H "Authorization: Bearer ACCESS_TOKEN"Feito para programadores que lançam
- ✓ Todos os planos — incluindo o Grátis — incluem acesso à API, por isso qualquer comerciante pode instalar a sua aplicação
- ✓ Cinco idiomas incluindo árabe, totalmente da direita para a esquerda
- ✓ Uma ficha revista no Marketplace, com distribuição dentro da aplicação que cada comerciante já usa
- ✓ Empresas sandbox gratuitas para construir e testar, sem qualquer risco para contabilidade real
- ✓ Cobra diretamente aos seus clientes e fica com 100% da sua receita
- ✓ Limites de utilização por aplicação e por empresa, para que o tráfego de outras aplicações nunca consuma o seu
- ✓ Versionamento da API por data, com 12 meses de suporte após cada nova versão
Da ideia ao Marketplace
- 01
Criar conta de programador
Registe-se na consola para programadores — é gratuito e demora poucos minutos.
- 02
Desenvolver numa sandbox
Registe a sua aplicação e desenvolva com empresas sandbox gratuitas, sem qualquer risco para a contabilidade real de ninguém.
- 03
Passar a revisão da aplicação
Até ser aprovada, a sua aplicação só se pode ligar às suas próprias sandboxes. A revisão da aplicação verifica-a antes de empresas reais a poderem usar.
- 04
Passar a revisão da ficha
Submeta a ficha para o Marketplace. Quando a revisão da ficha a aprova, é publicada — e todas as empresas OneBooks podem encontrar e instalar a sua aplicação.
O mínimo de privilégios, por predefinição
- ✓ As páginas incorporadas funcionam em iframes isolados de origem cruzada, autenticadas com tokens de sessão de curta duração — nunca um cookie partilhado
- ✓ Cada instalação está limitada exatamente às permissões que pede, consentidas pelo comerciante, e nada mais
- ✓ As funções alojadas funcionam em workers isolados com uma lista declarada e aplicada dos destinos a que podem aceder
- ✓ Cada escrita feita pela sua aplicação é-lhe atribuída no registo de auditoria do comerciante
- ✓ Os comerciantes podem desinstalar a sua aplicação a qualquer momento — o acesso termina de imediato, em todo o lado
Lance mais depressa com as ferramentas oficiais
App Bridge
A biblioteca de navegador para páginas incorporadas: tokens de sessão, navegação, notificações, seletores e caixas de diálogo de confirmação.
SDK Node
Um cliente de servidor tipado para a API OAuth, com novas tentativas, troca de tokens e verificação de tokens de sessão e de webhooks.
SDK Functions
Tipos para escrever funções alojadas, e um executor local para as testar antes de as implementar.
CLI
Crie a estrutura de uma aplicação, implemente e teste funções alojadas numa sandbox, e publique novas versões a partir do seu terminal.
Modelo inicial
Uma aplicação incorporada pronta a executar que a CLI gera por si — OAuth, App Bridge, uma ação e um cartão na fatura, um recetor de webhooks e uma função alojada de exemplo, já ligados.
Os SDKs e a CLI estão em pré-visualização: instale-os a partir do código-fonte até serem publicados no npm.
A sua aplicação, à frente de todos os comerciantes OneBooks.
Crie uma conta de programador gratuita, construa numa sandbox, e publique num Marketplace em que os comerciantes já confiam.