API DOCUMENTATION
API
Jasmin provides a Web REST API that allows you to access a subscription's data. This API covers all of the product's modules (Sales, Purchases, Taxes, etc.) and allows you to view data as well as create and update entities and transactions (documents), which makes it possible to create solutions that integrate Jasmin with any other system.
Gestão das aplicações integradas
O sistema de autenticação de utilizadores e de segurança dos produtos requer que todas as aplicações integradas sejam registadas no sistema. Essa informação é utilizada no acesso à Web API para assegurar o acesso aos dados da subscrição de um determinado cliente.O registo da aplicação permite ao programador ter acesso ao token de autorização que deve ser utilizado em todas as chamadas à Web API A Web API utiliza o standard OAuth 2.0 para autorizar o acesso às subscrições e por consequência aos dados. Encontra-se disponível uma área que permite gerir o registo das suas aplicações de integração para programadores de aplicações de integração. Para mais informações sobre o OAuth 2.0, sugere-se a consulta dos seguintes artigos: O registo de aplicações encontra-se disponível na App Store que se encontra dividida em três áreas: Esta área está dividida em duas subáreas: Dashboard e Publisher . Nesta subárea é apresentada a lista de publishers associada à conta de utilizador, sendo permitido adicionar e remover publishers. Para adicionar um novo publisher basta clicar no Create Publisher na área Publisher e indicar os seguintes dados: Nesta subárea é permitido consultar, editar, publicar ou remover aplicações, bem como criar ou remover subscrições para testes. Para adicionar uma nova aplicação, siga os seguintes passos: Esta página de configuração está dividida em seis áreas, sendo necessário preencher as seguintes informações: General: Deverá preencher os seguintes campos: Logo & Images: Nesta área deverá indicar o logótipo da aplicação para efeitos informativos. Autorization Deverá inserir os seguintes dados: Ao selecionar os tipos de fluxo Client Credentials ou AuthorizationCode, deverá gerar um Client Secret no botão disponível para o efeito, sendo necessário gravar a aplicação após alteração do fluxo. Para obter o token que autoriza as chamadas à API é necessário possuir a chave da aplicação e o secret. Não é possível recuperar esta informação, por isso deverá guardá-la de forma segura. Contudo, é possível gerar um novo Client Secret através da opção Reset Client Secret. Additional Settings Deverá preencher os seguintes dados: Distribution Após preencher todos os requisitos necessários, é possível submeter a aplicação para aprovação através da opção Submit for approval. Será também apresentado o estado em que se encontra a aprovação da aplicação. Delete App Poderá remover a aplicação da App Directory através da opção Delete App. É possível editar as aplicações depois de as criar, exceto os campos: Poderá também efetuar o publish ou unpublish de aplicações, bem como solicitar a geração de novo Client Secret (esta opção apenas se encontra disponível para aplicações com os tipos de autenticação Client Credentials ou AuthorizationCode). Ao efetuar o publish, está a permitir que a aplicação fique visível na App Store do Jasmin e, assim, qualquer utilizador pode subscrevê-la e utilizá-la nas suas subscrições. Por outro lado, ao efetuar o unpublish, esta deixa de estar visível na App Store. No entanto, independentemente do unpublish, as aplicações podem continuar a ser utilizadas nas subscrições que a tenham associado previamente. Nota: Estas funcionalidades apenas se encontram disponíveis na edição de uma aplicação e na listagem de aplicações, no botão associado. 4) Subscrever uma aplicação sem a publicar Poderá utilizar ou partilhar o link de preview para visualizar o aspeto da aplicação na store, bem como para efetuar a subscrição da app para efeitos de teste ou para a manter como privada. Para que o desenvolvimento de uma aplicação integrada não interfira com as contas reais dos clientes, é possível criar uma subscrição de desenvolvimento que poderá utilizar para este efeito. Em termos funcionais e de dados iniciais, este tipo de subscrição é idêntica a uma subscrição DEMO. Este tipo de subscrição permite experimentar livremente o produto durante 30 dias com dados fictícios. Se uma subscrição de desenvolvimento expirar, o developer poderá sempre criar uma nova, sendo que perderá todos os dados inseridos na subscrição anterior. De referir que só poderá criar três subscrições. Ao remover uma subscrição, esta deixa imediatamente de estar disponível na área de Manager. Ao associar uma aplicação a uma subscrição está a permitir que esta seja utilizada na subscrição. Para associar a sua aplicação, siga os seguintes passos: Ao remover uma aplicação de uma subscrição, deixa de ser possível utilizar a aplicação nessa subscrição.Registo de aplicações
Área do Developer
Publisher
Dashboard
1) Adicionar nova aplicação
- Product: nome do produto;
- Key: identificador da aplicação (chave/clienteId que será usada nas aplicações integradoras);
- Name: o nome público da aplicação;
- Description: descrição da aplicação;2) Editar o registo de uma aplicação
3) Efetuar publish/unpublish de uma aplicação
5) Criar uma nova subscrição para efeitos de desenvolvimento
6) Remover subscrição
Subscribed Apps
1) Associar uma aplicação a uma subscrição
2) Remover uma aplicação de uma subscrição
PROGRAMMABLEWEB
O ProgrammableWeb é uma plataforma que permite acompanhar todas as novidades e informações sobre a Web API do Jasmin.