Ir para o conteúdo principal

[Gov.Doc] Manual Documental da API do Assine Aqui

Objetivo

O objetivo deste estudo é documentar as rotas da API do Sistema Gov.Doc. 

Introdução

O Gov.Doc é o sistema processador de texto do Governo do Estado de Rondônia e a sua API permite que outros sistemas (SOLAR, RegularizaJá, SID, etc) sejam capazes de criar, editar, arquivar documentos de maneira padronizada. Dessa forma, viu-se a necessidade de documentar as rotas para garantir e facilitar o acesso aos dados da API.

Bloco de Assinatura

O bloco de assinatura tem como sua principal funcionalidade permitir que o documento possa ser assinado por um ou mais usuários, assim como permite que o usuário assine um ou mais documentos simultaneamente, além de outras funcionalidades.

       • Rotas do Bloco de Assinatura
Rota GET • /BlocoDeAssinatura/{idDoBloco}
Descrição Rota que busca o bloco de assinatura pelo ID.
Parâmetros Id do bloco : string($uuid)
Request Body -
Response 
{
  "id": "8db0864d-4472-4ac1-a82e-a71643bc412a",
  "titulo": "Bloco de assinatura",
  "documentos": [],
  "dataDeCriacao": "2021-09-08T11:01:31.7264862",
  "criador": null,
  "sistemaCriadorId": "ac4bec90-cbe0-4460-8c40-860e6ba5e60b",
  "cpfDoAssinante": "00000000000",
  "justificativaDeRecusa": null,
  "dataDeRecusa": "0001-01-01T00:00:00",
  "status": 2
}
Rota POST • /BlocoDeAssinatura/Criar
DescriçãoRota para criar bloco de assinatura pelo CPF do usuário.
Parâmetros-
Request Body

• titulo : string → título do bloco de assinatura;

• documentosIds : List<Guid>→ lista com os IDs dos documentos inseridos no bloco;

• cpfDoCriadorDoBloco : string→ cpf do criador do bloco.

Response 
{
  "id": "a84ed15c-d197-4042-9171-599f56b43e00",
  "titulo": "string",
  "documentos": [
    {
      "id": "e82014a4-958a-4a0f-8da7-b8742e609ec7",
      "titulo": "teste",
      "sequencial": 102,
      "modeloId": 1,
      "numeracao": "001.000102/2022-20",
      "cpfDoCriador": "16545282000",
      "dataDeCriacao": "2022-08-24T09:39:18.2583907",
      "tipoDeDocumento": "Parecer",
      "unidadeOrcamentariaId": 20,
      "departamento": "string",
      "historicoDeEdicoes": [],
      "compartilhamentos": [],
      "assinaturas": [],
      "historicos": [],
      "emMinuta": true,
      "blocoDeAssinaturaId": "a84ed15c-d197-4042-9171-599f56b43e00",
      "imagens": [],
      "excluido": false,
      "restrito": false,
      "sistemaOrigemId": "ac4bec90-cbe0-4460-8c40-860e6ba5e60b",
      "arquivado": false,
      "codigoCrc": null,
      "somenteLeitura": false
    }
  ],
  "dataDeCriacao": "2022-08-24T09:41:55.8515836-04:00",
  "criador": "01154865266",
  "sistemaCriadorId": "00000000-0000-0000-0000-000000000000",
  "cpfDoAssinante": null,
  "justificativaDeRecusa": null,
  "dataDeRecusa": "0001-01-01T00:00:00",
  "status": 1
}
Rota POST • /BlocoDeAssinatura/CriarPorSistema
DescriçãoRota para criar bloco de assinatura pelo Guid do SISTEMA.
Parâmetros-
Request Body

• titulo : string → título do bloco de assinatura;

• documentosIds : List<Guid>→ lista com os Guids dos documentos inseridos no bloco;

• sistemaDeOrigemId : Guid→ Guid do sistema onde o bloco de assinatura será criado.

Response


Rota PUT • /BlocoDeAssinatura
DescriçãoRota para editar o bloco de assinatura.
Parâmetros-
Request Body

• documentosIds : List<Guid>→ lista com os Guids dos documentos inseridos no bloco;

• cpfDoCriadorDoBloco : string→ CPF do criador do bloco de assinatura (somente o criador do bloco pode editar);

• dataDeCriacao : dateTime → data de criação do bloco de assinaturas;

• blocoId : Guid → Guid do bloco de assinaturas.

Response


Rota PUT • /BlocoDeAssinatura/AdicionarDocumento
DescriçãoRota para adicionar documentos ao bloco de assinatura pelo CPF do usuário. 
Parâmetros-
Request Body

• documentosIds : List<Guid>→ lista com os Guids dos documentos inseridos no bloco;

• cpf : string→ CPF do usuário que irá adicionar o documento (apenas o criador do bloco pode adicionar documento);

• blocoId : Guid → Guid do bloco de assinaturas.

Response


Rota PUT • /BlocoDeAssinatura/AdicionarDocumentoPorSistema
DescriçãoRota para adicionar documentos ao bloco de assinatura pelo SISTEMA de origem.
Parâmetros-
Request Body

• documentosIds : List<Guid>→ lista com os Guids dos documentos inseridos no bloco;

• sistemaDeOrigemId : Guid → Guid do sistema onde o bloco de assinatura será criado (somente o sistema de origem criador do bloco pode adicionar documento).

• blocoId : Guid → Guid do bloco de assinaturas.

Response


Rota PUT • /BlocoDeAssinatura/RemoverDocumento
DescriçãoRota para remover documentos do bloco de assinatura pelo CPF do usuário.
Parâmetros-
Request Body

• documentosIds : List<Guid>→ lista com os Guids dos documentos inseridos no bloco;

• cpfDoUsuarioLogado : string→ CPF do usuário que irá excluir o documento (apenas o criador do bloco pode excluir documento);

• blocoId : Guid → Guid do bloco de assinaturas.

Response


Rota PUT • /BlocoDeAssinatura/RemoverDocumentoPorSistema
DescriçãoRota para remover documentos do bloco de assinatura pelo SISTEMA de origem.
Parâmetros-
Request Body

• documentosIds : List<Guid>→ lista com os Guids dos documentos inseridos no bloco;

• sistemaDeOrigemId : Guid → Guid do sistema onde o bloco de assinatura será criado (somente o sistema de origem criador do bloco pode adicionar documento).

• blocoId : Guid → Guid do bloco de assinaturas. 

Response

 

Rota POST • /BlocoDeAssinatura/DisponibilizarParaAssinatura
DescriçãoRota para disponibilizar os blocos para assinatura.
Parâmetros-
Request Body

• cpfDoCriadorDoBloco : string→ CPF do usuário que irá disponibilizar o bloco para assinatura;

• sistemaDeOrigemId : Guid → Guid do sistema que irá disponibilizar o bloco para assinatura;

• idDoBloco : Guid → Guid do bloco de assinaturas;

• assinante : → nome e cpf do usuário que irá assinar; 

    • nome : string;

    • cpf : string.

OBS: deve ser informado ao menos o cpfDoCriadorDoBloco OU sistemaDeOrigemId que criou o bloco. 

Response

 

Rota POST • /BlocoDeAssinatura/AssinarBloco
DescriçãoRota para assinar o bloco de assinaturas.
Parâmetros-
Request Body

• idDoBloco : Guid → Guid do bloco de assinaturas;

• cpf : string→ CPF do usuário que irá assinar o documento;

• senha : string → senha do usuário que irá assinar o documento;

• aceitouTermo : boolean → termo para assinar o documento.

Response

 

Rota PUT • /BlocoDeAssinatura/RemoverDocumentoPorSistema
Descrição
Parâmetros-
Request Body

 

Response

 

Voltar ao topo