Versões comparadas

Chave

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

...

A API de Lookup é uma API com intuito de trazer apenas dados para identificação de registros. (A partir da versão 12.1.2406,)
É implementada a partir da rota da API principal, e é apartada do sistema de permissionamento do RM.

...

titleAtenção

Como o Lookup pode ser utilizado em diversas telas, não é necessário que o usuário possua permissão na funcionalidade para utiliza-lo é necessário apenas ter um usuário válido para login.

As rotas de Lookup devem utilizar o atributo de autorização OnlyAuthenticatedAttribute pois é este atributo que permite um usuário AUTENTICADO ter acesso as rotas.

Bloco de código
languagec#
titleExemplo
    [OnlyAuthenticated]
    [Route("lookup")]
    public ApiDataServerResponse GetAllLookup([FromUri] ApiQuery query)
    {
     ....
    }


1 - Métodos

...

      Utilizado um único método implementado:

  • GET


2 - GET

...

Informações
iconfalse
titleGetAll

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

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Rota: companies

Url Utilizada: localhost:8051/api/framework/v1/companies/lookup

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "hasNext": false,
    "items": [
        {
            "id": "1",
            "code": 1,
            "nickname": "TOTVS SA",
            "federalId": "21.867.387/0001-58"
        },
        {
            "id": "6",
            "code": 6,
            "nickname": "INSTITUTO TOTVS DE ENSINO SA",
            "federalId": "25.578.337/0001-01"
        },
        {
            "id": "7",
            "code": 7,
            "nickname": "INSTITUTO TOTVS DE ENSINO SUPERIOR SA",
            "federalId": "05.295.401/0001-30"
        }
    ]
}


2.1 - Fields (Retorno de campos específicos no resultado)

...

Informações
titleParâmetros

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

1 - Métodos

      Utilizado um único método implementado:

  • GET

...

Informações
iconfalse
titleGetAllFields

Máscara de Url: http://{domínio}:{porta}/api/framework/v1/{rota}/lookup?fields={campos}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Rota: companies

Campo 1: nickname

Campo 2: federalId

Url Utilizada: http://localhost:8051/api/framework/v1/companies/lookup?fields=nickname,federalId

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "hasNext": false,
    "items": [
        {
            "idnickname": "1TOTVS SA",
            "codefederalId": 1,
"21.867.387/0001-58"
        },
        {
            "nickname": "INSTITUTO TOTVS DE ENSINO SA",
            "federalId": "2125.867578.387337/0001-5801"
        },
        {
            "idnickname": "6INSTITUTO TOTVS DE ENSINO SUPERIOR SA",
            "federalId": "05.295.401/0001-30"
        }
    ]
}



2.2 - Order (Resultado Ordenado)

Informações
titleParâmetros

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
iconfalse
titleOrder (Asc)

Máscara de Url: http://{domínio}:{porta}/api/framework/v1/{rota}/lookup?order={campo}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Rota: companies

Campo: nickname

Tipo de Ordenação: Ascendente

Url Utilizada: http://localhost:8051/api/framework/v1/companies/lookup?order=nickname

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "hasNext": 6false,
    "items": [
        "nickname{
            "id": "INSTITUTO TOTVS DE ENSINO SA"6",
            "code": 6,
            "federalIdnickname": "25.578.337/0001-01INSTITUTO TOTVS DE ENSINO SA"
        },
        {
            "id": "7",
            "code": 7,
            "nickname": "INSTITUTO TOTVS DE ENSINO SUPERIOR SA"
        },
        {
        "federalId    "id": "1",
            "code": 1,
            "nickname": "05.295.401/0001-30TOTVS SA"
        }
    ]
}

...



2.

...

3 - GetOne (Recuperar um único registro pelo identificador)

...

Informações
titleParâmetros

Expand: Foi desabilitado para esta Api.

Informações
iconfalse
titleGetOne

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

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8099

Rota: companies

Id: 6

Url Utilizada: localhost:8051/api/framework/v1/companies/lookup/6

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "id": "6",
    "code": 6,
    "nickname": "INSTITUTO TOTVS DE ENSINO SA",
    "federalId": "25.578.337/0001-01"
}

...