Histórico da Página
Sumário
...
Índice | ||
---|---|---|
|
Objetivo
...
Esse documento tem o objetivo de exemplificar o uso da API utilizando todos os métodos implementados.
Para mais informações sobre consumo de Licença, Veja Aqui.
1 - Métodos
...
Serão apresentados 4 métodos, os quais foram implementados na API de Usuários, são eles:
- GET
- POST
- PUT
- DELETE
1.1 - GET
...
1.1.1 - Get All (Recuperar todas as coligadas)
...
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
Expandir | Informações | | ||||||||||||||
|
Informações | ||||
---|---|---|---|---|
| ||||
Domínio: localhost Porta: 8051 Url Utilizada: http://localhost:8051/api/framework/v1/companies |
Aviso | ||
---|---|---|
| ||
A partir da versão 12.1.2310, o resultado não é filtrado pelo perfil de segurança do usuário, mantendo o mesmo padrão da MDI, trazendo todas as coligadas. |
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
1.1.2 - Order (Resultado Ordenado)
Informações | ||
---|---|---|
| ||
Order: parâmetro responsável pela ordenação do resultado, podendo ser ascendente ou descendente. O resultado com a ordem descendente deve ser precedida do caractere "-" (menos). Exemplo 1: ?order=campo1 (Ascendente) Exemplo 2: ?order=-campo1 (Descendente) Múltiplos campos de ordenação: ?order=[-]campo1, [-]campo2, [-]campo3 ... |
Informações | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||
Expandir | ||||||||||||||||||||||||||||||
Informações | ||||||||||||||||||||||||||||||
icon | false | title | Configuração||||||||||||||||||||||||||||
Máscara de Url: http://{domínio}:{porta}/api/framework/v1/campanies?order={campo}
|
Informações | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||
Expandir | ||||||||||||||||||||||||||||||
Informações | ||||||||||||||||||||||||||||||
icon | false | title | Configuração||||||||||||||||||||||||||||
Máscara de Url: http://{domínio}:{porta}/api/framework/v1/companies?order=[-]{campo}
|
1.1.3 - Filter (Resultado filtrado)
...
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
Máscara de Url: http: Expandir | Informações | | ||||||||||||||
|
Informações | ||||
---|---|---|---|---|
| ||||
Domínio: localhost Porta: 8051 Campo: state Valor: MG Url Utilizada: http://localhost:8051/api/framework/v1/companies?state=MG |
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
1.1.4 - Paginação
...
Informações | ||
---|---|---|
| ||
Page: Página que será apresentada. PageSize: Quantidade máxima de registros por página que serão apresentados. Exemplo: ?page=valor1&pageSize=1 Valores padrão: Caso não sejam preenchidos os parâmetros evidenciados acima serão preenchidos com valores padrão. Page: 1 PageSize: 20 |
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
Expandir | Informações | | ||||||||||||||
|
Informações | ||||
---|---|---|---|---|
| ||||
Domínio: localhost Porta: 8051 Valor1: 1 Valor2: 2 Url Utilizada: http://localhost:8051/api/framework/v1/companies?page=1&pageSize=2 |
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
1.1.5 - Fields (Retorno de campos específicos no resultado)
...
Informações | ||
---|---|---|
| ||
Fields: parâmetro responsável pela especialização de campos em um resultado, ou seja, o usuário define quais campos serão apresentados no resultado. Exemplo: ?fields=campo1 Múltiplos campos de ordenação: ?fields=campo1, campo2, campo3 ... |
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| expand||||||||||||||||
Informações | | |||||||||||||||
|
Informações | ||||
---|---|---|---|---|
| ||||
Domínio: localhost Porta: 8051 Campo 1: nickname Campo 2: federalId Url Utilizada: http://localhost:8051/api/framework/v1/companies?fields=nickname,federalId |
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
1.1.6 - GetOne (Recuperar coligada pelo identificador)
...
Informações | ||
---|---|---|
| ||
Expand: Parâmetro opcional, usado para determinar a(s) propriedade(s) expandables que devem ser retornadas expandidas. Exemplo: ?expand=roles - Nesse exemplo, os perfis associados ao usuário serão retornados na resposta da requisição. Valores padrão: Caso não sejam preenchidos todas as propriedades expandables serão retornadas sem serem expandidas. |
Informações | |||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||
Expandir | |||||||||||||||||||||||||||||||
Informações | |||||||||||||||||||||||||||||||
icon | false | ||||||||||||||||||||||||||||||
Configuração |
Informações | ||||
---|---|---|---|---|
| ||||
Domínio: localhost Porta: 8099 Id: 00001 Url Utilizada: http://localhost:8051/api/framework/v1/companies/6 |
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
Informações | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||
Expandir | ||||||||||||||||||||||||||||||
Informações | ||||||||||||||||||||||||||||||
icon | false | title | Configuração||||||||||||||||||||||||||||
Máscara de Url: http://{domínio}:{porta}/api/framework/v1/companies/{id}?expand={campo}
|
1.2 - POST
...
1.2.1 - Post (Inserir uma Coligada)
...
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
Expandir | Informações | | ||||||||||||||
|
Informações | ||||
---|---|---|---|---|
| ||||
Domínio: localhost Porta: 8051 Url Utilizada: http://localhost:8051/api/framework/v1/companies |
Informações | ||||
---|---|---|---|---|
| ||||
Para incluir uma imagem no corpo (Body) na hora de realizar um POST (inclusão de registro), a imagem deve ser informada no formato Array de Byte. |
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
1.3 - PUT
...
1.3.1 - Put (Atualizar uma Coligada)
...
Informações | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Expandir | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Informações | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
icon | false | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Configuração |
Informações | ||||
---|---|---|---|---|
| ||||
Domínio: localhost Porta: 8051 Id: 12 Url Utilizada: http://localhost:8051/api/framework/v1/companies/12 |
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
1.4 - PATCH
...
1.4.1 - Patch (Atualização parcial de uma Coligada)
...
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
Expandir | Informações | | ||||||||||||||
|
Informações | ||||
---|---|---|---|---|
| ||||
Domínio: localhost Porta: 8051 Id: 12 Url Utilizada: http://localhost:8051/api/framework/v1/companies/12 |
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
Informações | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
1.4 - DELETE
...
1.4.1 - Delete (Desativa uma Coligada)
...
Informações | ||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||
Expandir | ||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
Informações | ||||||||||||||||||||||||||||||||||||||||||||
icon | false | title | Configuração||||||||||||||||||||||||||||||||||||||||||
Máscara de Url: http://{domínio}:{porta}/api/framework/v1/companies/{id}
|