> For the complete documentation index, see [llms.txt](https://doc.ozforensics.com/oz-knowledge/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.ozforensics.com/oz-knowledge/oz-knowledge/pt-br/geral/integration-quick-start-guides/face-matching/how-to-add-face-matching-of-liveness-video-with-a-reference-photo-from-your-database.md).

# Como adicionar Face Matching do vídeo de Liveness com uma foto de referência do seu banco de dados

{% hint style="warning" %}
Observe: este guia se aplica somente ao fluxo sem container.
{% endhint %}

Este guia descreve como associar um vídeo de Liveness a uma foto de referência de uma pessoa que já está armazenada em seu banco de dados.

No entanto, se você preferir incluir uma etapa de captura de foto de documento de identidade em seu processo de Liveness em vez de usar uma foto armazenada, então você pode consultar [outro guia](/oz-knowledge/oz-knowledge/pt-br/geral/integration-quick-start-guides/face-matching/how-to-add-photo-id-capture-and-face-matching-to-your-web-or-mobile-application.md) nesta seção.

<figure><img src="/files/3bc9f47905da2ef54116d7a1915eb6669e16a8b7" alt=""><figcaption></figcaption></figure>

Até este ponto, você já deve ter implementado a gravação de vídeo de Liveness e a verificação de Liveness. Se não, consulte estes guias:

* [Integração do Oz Liveness Web SDK](broken://pages/c70f8fab27c8f914e382bf760a27d848cc2f5be5)
* [Integração do Oz Liveness Mobile SDK](broken://pages/3f61114002a2e62adf64a7e3dc03aabc7b869555)

Neste cenário, carregue sua imagem de referência para a mesma pasta onde você tem um vídeo de Liveness, inicie a análise BIOMETRY e consulte os resultados.

#### 1. Obtenha `folder_id`

Como você já tem o vídeo de Liveness gravado e enviado, você trabalhará com a mesma pasta do Oz API onde está o seu vídeo de Liveness. Obtenha o ID da pasta conforme descrito abaixo e passe-o ao seu back-end.

* Para um vídeo gravado pelo Web SDK, obtenha o `folder_id` conforme descrito [aqui](https://doc.ozforensics.com/oz-knowledge/guides/developer-guide/sdk/oz-liveness-websdk/configuration-and-usage/web-plugin/security-recommendations#retrieve-the-analysis-response-and-process-it-on-the-back-end).
* Para um vídeo gravado pelo Android ou iOS SDK, recupere o `folder_id` dos resultados da análise, conforme mostrado abaixo:

**Android**:

{% tabs %}
{% tab title="Kotlin" %}

```kotlin
AnalysisRequest.Builder()
        ...
        .run(object : AnalysisRequest.AnalysisListener {
            override fun onSuccess(result: List<OzAnalysisResult>) {
                // salve o folder_id necessário para a próxima etapa
                val folderId = result.firstOrNull()?.folderId
            }
            ...
        })
```

{% endtab %}

{% tab title="Java" %}

```java
private void analyzeMedia(List<OzAbstractMedia> mediaList) {
    new AnalysisRequest.Builder()
            ...
            .run(new AnalysisRequest.AnalysisListener() {
                @Override public void onStatusChange(@NonNull AnalysisRequest.AnalysisStatus analysisStatus) {}
                @Override
                public void onSuccess(@NonNull List<OzAnalysisResult> list) {
                    String folderId = list.get(0).getFolderId();
                    }
                }
                ...
    });
}
```

{% endtab %}
{% endtabs %}

**iOS**:

<pre class="language-swift"><code class="lang-swift">analysisRequest.run(
scenarioStateHandler: { state in }, 
uploadProgressHandler: { (progress) in }  
)   { (analysisResults : [OzAnalysisResult], error) in 
        // salve o folder_id necessário para a próxima etapa
        let folderID = analysisResults.first?.folderID
    }
<strong>}
</strong></code></pre>

#### 2. Faça o upload da sua foto de referência

[Chame](https://apidoc.ozforensics.com/#tag/Media/paths/~1api~1folders~1%7Bfolder_id%7D~1media/posthttps://apidoc.ozforensics.com/#tag/Media/paths/~1api~1folders~1%7Bfolder_id%7D~1media/post) `POST /api/folders/{{folder_id}}/media/` método, substituindo o `folder_id` pelo ID que você obteve na etapa anterior. Isso fará o upload da sua nova mídia para a pasta onde está localizado o seu vídeo de Liveness pronto.

Defina as tags apropriadas no campo payload da solicitação, dependendo da natureza da foto de referência que você tiver.

```json
{
  "media:tags": { 
    "photo1": [
        "photo_id", "photo_id_front" // para o lado frontal de um documento de identidade
        // OU
        "photo_selfie" // para uma foto sem documento de identidade
    ]
  }
}
```

#### 3. Inicie a análise

Para iniciar a análise, [chame](https://apidoc.ozforensics.com/#tag/Analyses/paths/~1api~1folders~1%7Bfolder_id%7D~1analyses/post) `POST /api/folders/{{folder_id}}/analyses/` com o `folder_id` da etapa anterior. No corpo da solicitação, especifique a verificação de biometria a ser iniciada.

```json
{
    "analyses": [
        {
            "type": "biometry"
        }
    ]
}
```

#### 4. Consulte os resultados

Repita [chamando](https://apidoc.ozforensics.com/#tag/Analyses/paths/~1api~1analyses~1%7Banalysis_id%7D/get) `GET /api/analyses/{{analysis_id}}` com o `analysis_id` da etapa anterior uma vez por segundo até que o estado mude de `PROCESSING` para algo diferente. Para uma análise concluída:

* obtenha o resultado qualitativo da resolução (`SUCCESS` ou `DECLINED`).
* obtenha os resultados quantitativos de `analyses.results_data.min_confidence`

Aqui está a COLLECTION do Postman para este guia.

{% file src="/files/60c28908d5c6a59f0493b1b02fd8ab54aa9f4274" %}

Com essas etapas concluídas, você terminou de adicionar a correspondência facial via Oz API. Você poderá acessar sua mídia e os resultados da análise na Web UI pelo navegador ou de forma programática via API.

Os métodos do Oz API podem ser combinados com grande flexibilidade. Explore o Oz API usando o [Guia do Desenvolvedor da API](https://doc.ozforensics.com/oz-knowledge/guides/developer-guide/api/oz-api).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.ozforensics.com/oz-knowledge/oz-knowledge/pt-br/geral/integration-quick-start-guides/face-matching/how-to-add-face-matching-of-liveness-video-with-a-reference-photo-from-your-database.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
