O aplicativo RM.Host é responsável por hospedar e expor os serviços de APIs. Veja mais sobre a configuração da porta webApi.
Abaixo estão listadas as APIs de Framework:
Através do link http://{dominio}:{porta}/api/swagger/ disponibilizado pelo RM.Host.exe, é possível listar todas as api's da linha RM, disponíveis. Nesse endereço é possível visualizar todos os métodos implementados, o formato ao ser utilizado nos dados de entrada, o formato dos dados de saída, entre outras informações sobre as api's desenvolvidas. Desabilitar o SwaggerPara desabilitar o acesso ao Swagger pelo link acima, é necessário adicionar a seguinte chave ao <appSettings> do RM.Host.exe.config: <add key="DisableSwagger" value="true" /> O FrameHTML também possui um acesso ao Swagger pela URL http://{dominio}:{porta}/swagger/; para desabilitá-lo, adicione a chave acima ao <appSettings> do Web.config, localizado na pasta FrameHTML. |
Na API de Usuário é utilizado dois padrões:
Este guia define os padrões que devem ser adotados durante a implementação de novas APIs publicas ou privadas na plataforma TOTVS incluindo:
Mais em "Guia de implementacao das APIs TOTVS"
O SCIM (System for Cross-domain Identity Management ou Sistema de Gerenciamento de Identidade de Domínio Cruzado) é um padrão aberto para automatizar a troca de informações de identidade do usuário entre domínios de identidade e aplicações.
Na API de Usuários estão expostos os métodos:
Especificações | Título | Comentário |
---|---|---|
RFC 7231, sessão 4: Request methods | Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content | Especifica os métodos GET, HEAD, POST, PUT, DELETE, CONNECT, OPTIONS, TRACE. |
RFC 5789, sessão 2: Patch method | PATCH Method for HTTP | Especifica o método PATCH. |
O Método GET solicita a representação de um recurso específico. Requisições utilizando o Método GET devem retornar apenas dados.HEAD O Método HEAD solicita uma resposta de forma idêntica ao método GET, porém sem conter o recurso "body"(corpo).
O Método POST é utilizado para submeter uma entidade a um recurso específico, às vezes causando uma mudança no estado do recurso ou solicitando alterações ao servidor.
O Método PUT substitui todas as atuais representações de seu recurso alvo pela carga de dados da requisição.
O Método DELETE remove um recurso específico.
Importante: Lembre-se que ao informar valores inteiros para propriedades, eles devem ser informados sem o 0 (zero) à esquerda. Caso seja enviado com o 0 (zero), o valor inteiro deve estar entre aspas duplas:
Ex.: "day": 8 ou "day": "08".
Isso acontece porque ao utilizar um inteiro com um 0 a esquerda o C# entende que este inteiro é base Octal ( de 0 a 7) onde os caracteres 8 e 9 são inválidos.
O consumo de Licença foi desativado para as seguintes APIs:
A partir das versões e patchs listados abaixo:
Para demais versões anteriores o consumo permanece ativado. |