Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Sumário

...


Índice
excludeSumário

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 RiscosArquivos, são eles:

  • GET ALL
  • POST
  • GET (download do arquivo)
  • POST (upload do arquivo)PUT
  • DELETE

1.1 - GET

...

1.1.1 - Get All (Recuperar todos os

...

arquivos do conector específico)

...

Informações
iconfalse
title1.1.1 GetAll
Expandir
Informações
iconfalse
titleConfiguração

...

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 ...

Padrão scim:

SortBy: define o campo que será ordenado.

SortOrder: parâmetro responsável pela ordenação do resultado, podendo ser ascendente ou descendente.

Exemplo 1: ?sortBy=campo1&sortOrder=ascending (Ascendente)

Exemplo 2: ?sortBy=campo1&sortOrder=descending (Descendente)

Informações
titleParâmetros
Informações
iconfalse
title1.1.1.2 Order (Asc)
Expandir
Informações
iconfalse
titleConfiguração

Máscara de Url: http://{domínio}:{porta}/api/framework/v1/sod/risks

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Url Utilizada: http://localhost:8051/api/framework/v1/sod/risks

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "hasNext": false,
    "items": [
        {
            "id": 5,
            "companyId": 0,
            "name": "Risco-alto",
            "alertId": 5
        },
        {
            "id": 6,
            "companyId": 1,
            "name": "Risco-medio",
            "alertId": 3
        },
        {
            "id": 7,
            "companyId": 1,
            "name": "Risco-medio-baixo",
            "alertId": 2
        },
        {
            "id": 9,
            "companyId": 1,
            "name": "Risco-baixo",
            "alertId": 2
        },
        {
            "id": 10,
            "companyId": 1,
            "name": "Risco-medio-alto",
            "alertId": 4
        },
        {
            "id": 12,
            "companyId": 1,
            "name": "Risco-baixissmo",
            "alertId": 0
        }
    ]
}

...

Máscara de Url: http://{domínio}:{porta}/api/glb/v1/framework?order=[-]{campo}filerepo/connectors/{{connectorId}}/files

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Campo: active

Tipo de Ordenação: Ascendente

Url Utilizada: http://localhost:8051/api/framework/v1/filerepo/connectors/sod/risks?order=-alertId1/files

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "hasNext": false,
    "items": [ 
        
		{
            		"id": 520,
            "companyId": 0,
            "name": "Risco-alto",
            "alertId": 5
        }, 
        {
            "id": 10,
            "companyId": 		"connectorId": 1,
            "name		"fileName": "Risco-medio-altoarquivo.txt",
            "alertId": 4
        }, 
        {
            "id": 6,
            "companyId": 1,
            "name": "Risco-medio",
            "alertId": 3
        },
        		"fileIdentifier": "fds8DFASdas9jw"
		},
		{
            		"id": 721,
            "companyId		"connectorId": 1,
            "name		"fileName": "Risco-medio-baixoarquivo2.txt",
            "alertId": 2
        },
        {
            "id": 9,
            "companyId": 1,
            "name": "Risco-baixo",
            "alertId": 1
        },
        {
            "id": 12,
            "companyId": 1,
            "name": "Risco-baixissmo",
            "alertId": 0
        }
    		"fileIdentifier": "fdfdss8DFASdas9jdasw"
		}      
	]
}

1.1.2 -

...

Download (

...

Baixar arquivo pelo

...

identificador)

...


Informações
iconfalse
title1.1.2 GetOne
Expandir
Informações
iconfalse
titleConfiguração

Máscara de Url: http://{domínio}:{porta}/api/framework/v1/sodfilerepo/risksfiles/{{id}}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Id: 20

Url Utilizada: http://localhost:8051/api/framework/v1/sodfilerepo/risksfiles/20

Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "id": 20,
    "companyId": 1,
    "name": "Risk-Teste",
    "alertId": 0
}FILECONTENT


1.2 - POST

...

1.2.1 - Post (

...

Fazer upload de um

...

arquivo)

...

Informações
iconfalse
title1.2.1 Post
Expandir
Informações
iconfalse
titleConfiguração

Máscara de Url: http://{domínio}:{porta}/api/framework/v1/sodfilerepo/risksfiles

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Url Utilizada: http://localhost:8051/api/framework/v1/sodfilerepo/risksfiles

Informações
iconfalse
titleExemplo de Entrada
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "companyId"MULTIFORM-DATA:
	connectorId: 1,
    "name": "Risk-Teste",
    "alertId": 0
}
	file: arquivo.txt
Informações
iconfalse
titleExemplo de Resultado Positivo
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "id": 20,
    "companyIdconnectorId": 1,
    "namefileName": "Risk-Teste",
    "alertId": 0
}

1.3 - PUT

1.3.1 - Put (Atualizar um risco)

Informações
iconfalse
title1.3.1 Post
Expandir
Informações
iconfalse
titleConfiguração

Máscara de Url: http://{domínio}:{porta}/api/framework/v1/users/{id}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Id: 20

Url Utilizada: http://localhost:8051/api/framework/v1/sod/risks/20

Informações
iconfalse
titleExemplo de Entrada
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "companyId": 1arquivo.txt",
    "alertIdfileIdentifier": 2,
    "name": "Risco-Alterado"
}
Informações
iconfalse
titleExemplo de Resultado Positivo
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "id": 20,
    "companyId": 1,
    "alertId": 2,
    "name": "Risco-Alterado"fds8DFASdas9jw"
}

1.

...

3 - DELETE

...

1.

...

3.1 - Delete (Deletar um

...

arquivo)

...

Informações
iconfalse
title1.43.1 Delete
Expandir
titleClique aqui para expandir...
Informações
iconfalse
titleConfiguração

Máscara de Url: http://{domínio}:{porta}/api/framework/v1/sodfilerepo/risksfiles/{id}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Id: 20

Url Utilizada: http://localhost:8051/api/framework/v1/sodfilerepo/risksfiles/20

Informações
iconfalse
titleResultado esperado

Será retornado o respondeCode = 204 e a resposta em branco.