Primeiros passos

Neste documento, você encontra um guia passo a passo sobre como começar a utilizar as APIs MySafe de forma rápida e eficiente.
Siga os passos abaixo para integrar a sua aplicação ao MySafe e começar a aproveitar os recursos oferecidos.

Requisitos

• Permissão de administrador do MySafe.

Criar aplicação e autorização

A criação de uma aplicação e de sua autorização para utilizar as APIs MySafe é feita diretamente no MySafe.

1. No senhasegura, no canto superior direito, clique em Grid Menu, representado pelos nove quadrados e selecione MySafe.
2. No menu lateral, selecione Integrações > Chaves de acesso.
3. Na tela Chaves de acesso, clique no menu Exibir ações, representado pelo ícone dos três pontos verticiais, e selecione Nova.
4. Preencha os campos na tela Nova chave de acesso e clique em Salvar.

Acesse o documento sobre Como adicionar uma autorização de chave de acesso para mais informações.

Autenticar a aplicação

Após a criação da aplicação e de sua autorização, utilize o Client ID e o Client Secret gerados pelo MySafe para obter um Access Token que deverá ser utilizado para validar e autorizar todas as chamadas de API subsequentes.

Acesse o documento Como visualizar uma autorização de chave de acesso para mais informações.

1. No cliente HTTP ou REST de sua escolha, como o Postman, crie uma coleção.
2. Na guia Authorization > Type, selecione OAuth 2.0.
3. Em Configure New Token > Configuration Options > Grant Type, selecione Client Credentials.
4. Em Access Token URL, faça uma requisição para o endpoint do servidor da autorização. Por exemplo,

GET {{senhasegura}}/api/oauth2/token

5. Em Client ID, insira o valor gerado adicionar uma chave de autorização de acesso no MySafe.
6. Em Client Secret, insira o valor gerado adicionar uma chave de autorização de acesso no MySafe.
7. Clique em Get New Access Token, na parte inferior da página.
8. Clique em Proceed para abrir a página MANAGE ACCESS TOKENS e visualizar o Access Token gerado.
9. Use este Access Token para fazer as requisições nas APIs MySafe.

Requisições e respostas

As requisições são feitas usando métodos HTTP como GET, POST e PUT.

Os parâmetros incluem identifier, name, note, entre outros, e a depender da chamada, podem ser enviados no path da URL, no body da requisição ou como query.

As respostas são retornadas em formato JSON, facilitando a análise e o gerenciamento de dados fornecidos pela API.

Exemplo:
Ao fazer uma requisição para o endpoint GET /api/mysafe/password/197, a API retorna os dados da senha armazenada cujo id é igual a 197.

{
    "code": 200,
    "response": {
        "status": 200,
        "message": "Success",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "Success",
        "erro": false,
        "cod_erro": 0
    },
    "password_entity": {
        "identifier": "197",
        "name": "Testing",
        "url": "www.url.com",
        "username": "maria",
        "password": "Cs^Q4PdbIOo4",
        "secret_key": JBSWY3DPEHPK3PXP,
        "token": 452180,
        "notes": "This is a test password",
        "tags": "test",
        "users_allowed": [],
        "groups_allowed": []
    }
}

Cada documento apresenta uma descrição dos campos do corpo da resposta.
Acesse o documento GET | Listar uma senha por [identifier] para visualizar a descrição dos campos listados na resposta acima.

Erros

A API retorna códigos de status HTTP padrão e inclui mensagens de erro no corpo da resposta para facilitar a compreensão e a resolução de problemas.

Exemplo:
A mensagem a seguir retorna um erro para o caso de senha não encontrada.

{
    "response": {
        "status": 400,
        "mensagem": "1005: Password not found",
        "erro": true,
        "cod_erro": 0,
        "message": "1005: Password not found",
        "error": true,
        "error_code": 0
    },
    "exception": {
        "code": 1005,
        "message": "1005: Password not found",
        "detail": ""
    }
}

Acesse a documentação de cada método para descrições detalhadas dos erros, suas possíveis causas e soluções.

Links para as documentações das APIs MySafe

Consulte os documentos abaixo para informações mais detalhadas e exemplos:

• Senhas.

• Anotações.

• Segredos de API.