# Guia de Integração do Intelligence

## Introdução

Este manual descreve o fluxo de trabalho de integração padrão do GBS Intelligence, que permite a busca biográfica no banco de dados. Qualquer chamada de API mencionada neste manual deve ser realizada de acordo com a [Especificação de API do GBS Intelligence](https://gitbook.griaule.com/apis/intelligence) .

{% hint style="info" %}
Todas as chamadas para o GBS Intelligence devem ser realizadas para o servidor ETR, conforme mencionado na especificação da API.
{% endhint %}

## Login

Qualquer solicitação à GBS Intelligence requer um login autenticado `session-guid`. Para obtê-lo , é necessário enviar `session-guid`uma solicitação [de login, informando uma combinação válida de usuário/senha.](https://gitbook.griaule.com/apis/intelligence/endpoints#post-session)

{% hint style="info" %}
O usuário e a senha devem ser os mesmos usados ​​para fazer login no GBDS e outros aplicativos Griaule.
{% endhint %}

A operação de login retornará um session-guid que deve ser fornecido em todas as solicitações ao GBS Intelligence.

## Lista de Campos de Busca por Request

Qualquer request de busca submetida ao GBS Intelligence deve especificar o campo biográfico a ser usado. Para verificar os campos biográficos disponíveis, pode-se usar [listSearchFields](https://gitbook.griaule.com/apis/intelligence/fields)

{% hint style="info" %}
If the biographic field name specified in the search request does not match a field that exists within the database, an error will be returned.
{% endhint %}

## Pesquisando por Valor

Ao realizar uma solicitação de pesquisa, é recomendável dividir o fluxo de trabalho em duas etapas: contagem e lista.

Ao contar os resultados disponíveis para os critérios de pesquisa fornecidos antecipadamente, é possível paginar os resultados, evitando qualquer sobrecarga na recuperação e visualização dos resultados.

Após a contagem dos resultados, é possível solicitar e paginar os resultados da pesquisa por meio dos parâmetros de consulta da solicitação.

### Contar

A solicitação [de resultados da pesquisa de contagem](https://gitbook.griaule.com/dev/api/intelligence/profiles#post-profile-list-count) deve conter os campos `name`e `value`a serem pesquisados.

{% hint style="info" %}
Qualquer perfil que contenha o valor a ser pesquisado dentro do campo biográfico fornecido será retornado como resultado da pesquisa, independentemente da posição.

por exemplo, uma expressão regular que descreve os critérios de pesquisa seria `*value*`, sendo `*`um curinga que abrange qualquer caractere em qualquer quantidade.
{% endhint %}

### Lista

A solicitação [de Resultados da Pesquisa de Lista](https://gitbook.griaule.com/dev/api/intelligence/profiles#post-profile-list) também deve conter os campos `name`e `value`a serem pesquisados, e os critérios de pesquisa serão os mesmos usados ​​para contar os resultados.

Esta solicitação aceita parâmetros de consulta que podem ser usados ​​para filtrar a lista retornada, como `first`, que determina a posição do primeiro resultado retornado na lista, e `size`, que define o número de resultados a serem retornados, começando pelo `first`.

## Acessando detalhes do perfil

Após realizar a pesquisa e recuperar os resultados, é possível usar os PGUIDs retornados para acessar os detalhes do perfil por meio da chamada [Request Profile](https://gitbook.griaule.com/apis/intelligence/profiles#get-profile-person-pguid).

Este método retornará todos os dados do perfil do PGUID fornecido, incluindo dados biográficos e imagens codificadas em base64.

## Ferramenta de conversão de imagem

O GBS Intelligence também fornece um método para [converter imagens](https://gitbook.griaule.com/apis/intelligence/image-conversion#post-image-convert) em diferentes formatos, fornecendo a imagem original codificada em base64, seu formato e o formato desejado para conversão.