Histórico da Página
...
- Pré-requisitos
- O modelo de implementação da API T-Reports foi criado seguindo o documento "Guia de implementação de API" disponível no link abaixo:
http://tdn.totvs.com/pages/viewpage.action?pageId=274849083 - Plataforma com suporte REST e autenticação Basic.
- Suporte a a tratamento cross-domain, por conta das requisições de serviços em servidores de domínio diferente.
- O modelo de implementação da API T-Reports foi criado seguindo o documento "Guia de implementação de API" disponível no link abaixo:
- Definições gerais
Os retornos dos serviços REST devem estar encapsulados dentro de um objeto JSON com a seguinte especificação:
Mensagens de erroPara todas as mensagens que representam um erro (códigos HTTP 4xx e 5xx) deve-se retornar obrigatoriamente os campos a seguir:
{
code:
"Código identificador do erro"
,
message:
"Literal no idioma da requisição descrevendo o erro para o cliente"
,
detailedMessage:
"Mensagem técnica e mais detalhada do erro"
}
Mensagens de sucessoMensagens de sucesso (código http 2xx devem) devem retornar diretamente a entidade que representa o objeto resultado da operação do endpoint. Ex:
GET http:
//totvs.com.br/api/trep/v1/dataproviders/1
{
code:
"0001"
,
description:
"provedor de DB"
...
}
Todas as linhas de produto deverão estabelecer uma URL base, a partir da qual os serviços REST de provedor integrado de "banco de dados" serão disponibilizados.
Todos os caminhos descritos neste documento serão relativos a esta URL base.
- Como exemplo, no ERP RM foi definida a seguinte URL base:
/api/trep/v1/dbdataproviders/ - Com o intuito de facilitar o entendimento do documento, a URL base do RM descrita acima será utilizada no restante do documento.
- Descrição dos serviços
Os serviços REST descritos a seguir estão divididos em:
- Serviço de leitura de parâmetros gerais;
- Serviço de teste de conexão;
- Serviço de teste de sentença sql;
- Serviço de leitura de schema de tabelas fisicas;
- Serviço de leitura de schema de sentença sql;
- Serviço de retorno de dados;
Na descrição de cada serviço podemos encontrar os seguintes elementos:
- Definição da URL do serviço;
- Parâmetros de request (entrada) e response (saída);
- Descrição do serviço com detalhes relativos ao seu funcionamento;
- Serviço de leitura de parâmetros gerais;
GET /api/trep/v1/dbdataproviders/parameters
Recebe
Não recebe parâmetros
Retorna
Application/JSON
Esse método é utilizado para obter os parâmetros do provedor integrado do tipo "banco de dados". A necessidade e definição desses parâmetros é de responsabilidade do dono do provedor. Os parâmetros retornados por esse serviço aparecerão na grid de parâmetros localizada no "cadastro de provedores de dados" do front-eend do T-Reports. No JSON de retorno, deve constar as seguintes informações:
- name: Nome do parâmetro;
- description: Descrição do parâmetro;
- value: Valor do parâmetro;
isPassword: Define se o valor do parâmetro será gravado e mostrado de forma criptografada. Pode ser “true” ou “false”
Informações title Exemplo de json de retorno {
“providerParams” : [{
“name” : “aliasName”,
“description” : “Nome do alias do RM”,
“value” : “CorporeRM”,
“isPassword” : false,
}]
}