Manual do Cedente de Dados

1. Pré-requisitos técnicos para disponibilizar APIs

  1. Deve estar disponível na internet através do protocolo https;

  2. Deve ser disponibilizada a documentação do serviço, preferencialmente no formato OpenAPI (ver Referências para Documentação de APIs);

  3. Deve ser disponibilizado ambiente de teste/homologação (não produtivo) para que seja possível testar a integração;

  4. Devem ser disponibilizadas credenciais de acesso, caso necessárias, para os ambientes de teste/homologação e produção;

  5. Deve ser cadastrado o certificado que foi fornecido pelo time do Conecta para que possa ocorrer o consumo do serviço, no caso onde a integração seja através de autenticação mútua;

  6. Deve ser informada a quantidade (capacidade) máxima de requisições por segundo que o serviço suporta;

  7. Deve ser definido o canal de comunicação com o suporte técnico do gestor do dado para que sejam informados possíveis problemas de indisponibilidade e/ou dúvidas durante a integração;

  8. Deve estar catalogada, ou em processo de catalogação, no Catálogo de APIs.

1.1 Como documentar minha API (Referências)

2. Como Gerenciar o acesso às minhas APIs

Para gerenciar o acesso a suas APIs, o órgão cedente de dados indicará um integrante, que será cadastrado pela equipe interna no perfil Gestor de APIs.

Para disponibilizar suas APIs, o Gestor de APIs deve:

  1. Cadastrar Plano de Consumo

    Um plano de consumo é o nome da associação de uma API com um limite de consultas. Ele especifica a quantidade máxima permitida de acessos à API para o período de um ano (limite de consumo).

    O Gestor de APIs pode realizar o controle de consumo de sua API através da definição de diferentes planos de consumo, que serão utilizados para limitar a consulta de diferentes órgãos recebedores de dados.

  2. Cadastrar adesão à API

    O cadastro de adesões à API permite que se conceda acesso a novos órgão às suas APIs gerenciadas.

Além dessas funcionalidades, o Gestor de APIs também pode:

  1. Listar Planos de Consumo

    Apresenta todos os planos de consumo cadastrados no Gerenciador de APIs do Conecta para este Gestor do Órgão.

  2. Listar órgãos cadastrados

    Apresenta todos os órgãos cadastrados no Gerenciador de APIs do Conecta.

  3. Cadastrar Gestor do órgão recebedor de dados

    Permite que um integrante do órgão recebedor de dados seja cadastrado com o perfil Gestor de API no Gerenciador de APIs do Conecta.

  4. Listar Gestor do órgão recebedor de dados

    Apresenta todos os Gestores de APIs do órgão recebedor de dados.

3. Instruções para o Gestor de APIs

3.1. Entre no Portal do Gestor

Logue no Gerenciador de APIs utilizando sua Conta gov.br.

Dica

Pode-se acessar a conta tanto com senha ou certificado digital

Esta é a tela inicial para o perfil Gestor de APIs, após o mesmo ter sido autenticado pelo Acesso gov.br:

Como fazer

3.2. Listar Planos de Consumo.

>> No menu Administração, selecionar o item Plano > Listar Planos de Consumo

Listar Planos de Consumo.
Os planos de consumo para as APIs do órgão provedordos dados podem ser filtrados de acordo com:
  • Nome da API (incluindo todas);

  • Nome do Plano de Consumo;

  • Limite

  • Situação

Após a escolha dos filtros, que é opcional, basta acionar o botão “Pesquisar” para gerar a lista dos planos de consumo de acordo com o critério de pesquisa definido pelos filtros.

Listar Planos de Consumo.

Atenção

A lista dos planos de consumo é apresentada em tela, com paginação e com as seguintes informações para cada plano de consumo:
  • Nome da API

  • Nome do Plano de Consumo

  • Limite do Plano de Consumo

  • Situação do Plano de Consumo

A partir da lista, é possível executar as seguintes ações para cada item, conforme ilustrado na tela abaixo:
  1. Ativar/desativar o plano de consumo

  2. Alterar o plano de consumo

  3. Cadastrar adesão à API

Listar Planos de Consumo. Listar Planos de Consumo.

A ação Ativar/desativar o plano de consumo faz com que o plano de consumo mude entre os estados ativado e desativado. Um plano de consumo ativado pode ser utilizado no cadastro de adesão de APIs, enquanto um desativado não permite a ação mencionada.

A ação Alterar o plano de consumo é similar à ação Cadastrar Plano de Consumo.

3.3. Cadastrar Plano de Consumo

>> No menu Administração, selecionar o item Plano > Cadastro de Novo Plano de Consumo.

Cadastrar Plano de Consumo
Na tela de cadastro, o Gestor do Órgão deve:
  1. Associar o plano de consumo sendo criado com a API para a qual ele vai ser utilizado;

  2. Preencher os campos com as informações do nome do plano de consumo e o limite permitido para o plano em questão (em quantidade de consultas).

  3. Efetivar o cadastro pelo botão Incluir.

Cadastrar Plano de Consumo.

Será exibida mensagem com o resultado da realização da inclusão, na parte superior da tela, abaixo do menu. Caso a inclusão seja realizada com sucesso:

Cadastrar Plano de Consumo.

Após a inclusão de um plano de consulta, é possível alterá-lo por meio do botão apresentado na parte inferior direita da tela. A alteração é realizada da mesma forma que o cadastro, sendo que os campos são apresentados preenchidos com os dados correntes do plano de consumo para serem alterados.

Cadastrar Plano de Consumo.

3.4. Cadastrar adesão à API

>> A partir da ação Cadastrar adesão à API no item desejado da lista de planos de consumo (conforme descrito em Listar Planos de Consumo), são exibidas as adesões existentes e é possível cadastrar novas adesões.

A tela de cadastro apresenta todas as adesões existentes para o órgão provedor de dados. O Gestor do Órgão deve:

  1. Associar o nome da API ao plano de consumo desejado;

  2. Efetivar o cadastro pelo botão Incluir.

Cadastrar adesão à API.

3.5. Listar Órgãos Cadastrados

>> No menu Administração, selecionar o item Órgão > Listar Órgão

Listar Órgãos Cadastrados
Os órgãos cadastrados podem ser filtrados de acordo com:
  • Nome do Órgão

  • Situação

Após a escolha dos filtros, que é opcional, basta acionar o botão “Pesquisar” para gerar a lista dos órgãos de acordo com o critério de pesquisa definido pelos filtros.

A lista dos órgãos é apresentada em tela, com paginação e com as seguintes informações para cada órgão:
  • Nome do Órgão

  • Sublista com as adesões existentes

  • Situação

A partir da lista, é possível executar a seguinte ação para cada órgão, conforme ilustrado na tela abaixo:

Listar Órgãos Cadastrados

3.6. Listar Gestor do órgão recebedor de dados

No menu Administração, selecionar o item Gestor > Listar Gestores

Listar Gestor do órgão recebedor de dados.
Os gestores podem ser filtrados de acordo com:
  • Nome do Órgão

  • Número do CPF

  • Nome

Selecionar (drop-down) Após a escolha dos filtros, que é opcional, basta acionar o botão “Pesquisar” para gerar a lista dos gestores de acordo com o critério de pesquisa definido pelos filtros. A lista dos gestores é apresentada em tela, com paginação e com as seguintes informações para cada gestor:

  • CPF

  • Nome

  • Órgão

  • Data de início do período de gestão

  • Data de fim do período de gestão

A partir da lista, é possível executar as seguintes ações para cada gestor:
  1. Ativar/Desativar gestor

  2. Alterar os dados do gestor

Listar Gestor do órgão recebedor de dados.

Um gestor desativado fica impedido de realizar ações na plataforma, inclusive a geração de novas chaves de acesso.

A alteração dos dados do gestor, por meio da ação Alterar os dados do gestor, é realizada de forma similar ao cadastro dos gestores do órgão conforme descrito em Cadastrar Gestor do órgão recebedor de dados

3.7. Cadastrar Gestor do órgão recebedor de dados

>> No menu Administração, selecionar o item Gestor > Cadastro de Novo Gestor.

Listar Gestor do órgão recebedor de dados
Nesta tela, o Gestor do Órgão deve:
  1. Selecionar o órgão do gestor sendo cadastrado. Caso o órgão selecionado seja vinculado ao SIAPE:

  1. Informar o CPF do gestor;

  2. Utilizar o botão Pesquisar Servidor, que busca automaticamente os dados restantes de cadastro para o CPF informado.

  3. Efetivar o cadastro pelo botão Incluir.

Listar Gestor do órgão recebedor de dados.
  1. Caso o órgão selecionado NÃO seja vinculado ao SIAPE:
    1. Informar o CPF do gestor;

    2. Informar os dados de cadastro do gestor;

    3. Efetivar o cadastro pelo botão Incluir.

    Listar Gestor do órgão recebedor de dados.