13. Integração de Outros Sistemas com o Fala.BR

Me-OUV é a API REST do Fala.BR.

Em linguagem bem simples, API é um conjunto de rotinas e padrões de programação para acesso a um aplicativo de software ou plataforma baseado na Web.

A sigla API refere-se ao termo em inglês "Application Programming Interface" que significa em tradução para o português "Interface de Programação de Aplicativos".

Por sua vez, Representational State Transfer (REST), que em português se traduz Transferência Representacional de Estado, é um estilo de arquitetura de software que define um conjunto de restrições a serem usados para a criação de web services (serviços Web).

Os Web services que estão em conformidade com o estilo arquitetural REST, denominados Web services RESTful, fornecem interoperabilidade entre sistemas de computadores na Internet.

Este roteiro foi feito para orientar a integração dos sistemas das unidades de ouvidoria dos órgãos (sistemas próprios de ouvidoria; SEI etc) ao sistema Fala.BR.

Foram utilizados como exemplo requisições ao ambiente de treinamento.

Para executar requisições da API utilizaremos a ferramenta Postman, cuja versão gratuita pode ser baixada e instalada em [1].

IMPORTANTE A documentação detalhada de cada requisição está disponível em [2] e [3].

3.1 Usuário de Aplicação

O primeiro passo para utilizar a API é obter um usuário para a aplicação.

Para isto deve-se solicitar acesso ao administrador do Fala.BR: OGU/CGOUV - Coordenação-Geral de Orientação e Acompanhamento de Ouvidorias, por meio do e-mail: suporte.e-ouv@cgu.gov.br.

Os perfis possíveis para usuários de sistema são:

3.1.1 Web service Atendente