> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/configuracao/ios/result-reference.md).

# Referência de resultado

### CafFaceLivenessLiteResult – Evento de sucesso

| Campo            | Descrição                                                                                                             |
| ---------------- | --------------------------------------------------------------------------------------------------------------------- |
| `signedResponse` | JWT opaco emitido com a sessão de liveness. Encaminhe-o para o seu backend; o SDK não o retorna `isAlive` ou imagens. |

{% hint style="info" %}
De **3.1.0**, o `signedResponse` é emitido quando a sessão de liveness é criada e entregue ao seu delegate no momento em que a captura é concluída — não há espera após a captura. Use-o com seu backend para obter o resultado final de liveness, conforme descrito em [Configuração do backend](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/configuracao/backend/setup.md); o SDK não faz polling por ele.
{% endhint %}

### CafErrorType – Tratamento de erros

O SDK informa erros de execução por meio de `didFinishWithError(type:description:)`. Apenas os tipos de erro abaixo são retornados por CafFaceLivenessLite. Para saber quando cada um é esperado e como orientar o usuário, consulte [Tratamento de erros](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/tratamento-de-erros/ios/error-handling.md):

| Erro                                                                                                                                                           |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`invalidOptionsException`](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/tratamento-de-erros/ios/error-handling.md#invalidoptionsexception)             |
| [`cameraPermission`](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/tratamento-de-erros/ios/error-handling.md#camerapermission)                           |
| [`securityException`](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/tratamento-de-erros/ios/error-handling.md#securityexception)                         |
| [`unsupportedDevice`](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/tratamento-de-erros/ios/error-handling.md#unsupporteddevice)                         |
| [`serverException`](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/tratamento-de-erros/ios/error-handling.md#serverexception)                             |
| [`tokenException`](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/tratamento-de-erros/ios/error-handling.md#tokenexception)                               |
| [`invalidResponseException`](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/tratamento-de-erros/ios/error-handling.md#invalidresponseexception)           |
| [`networkException`](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/tratamento-de-erros/ios/error-handling.md#networkexception)                           |
| [`captureAlreadyActiveException`](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/tratamento-de-erros/ios/error-handling.md#capturealreadyactiveexception) |
| [`userTimeoutException`](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/tratamento-de-erros/ios/error-handling.md#usertimeoutexception)                   |
| [`unexpectedErrorException`](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/tratamento-de-erros/ios/error-handling.md#unexpectederrorexception)           |

{% hint style="info" %}
`CafErrorType` é compartilhado com outros SDKs da Certta e também declara `imageNotFoundException`, `tooManyRequestsException`, `permissionException`, `libraryException`, `unknownException`, `cameraException`, `certificateException`, `faceAuthentication` e `livenessException`. CafFaceLivenessLite nunca os retorna. Se você `alternar` para `CafErrorType`, adicione um `padrão` caso em vez de tratar cada um deles.
{% endhint %}

### CafFailureType – Referências de falha

Códigos de feedback disponíveis retornados via `didFinishWithFailure(type:description:signedResponse:)`. O `tipo` é o motivo mais provável da falha, e qualquer código que o SDK não reconheça é retornado como `unknown`. `descrição` contém a mensagem localizada para esse motivo, e `signedResponse` está sempre presente — é o mesmo JWT emitido com a sessão, então encaminhe-o para o seu backend como faria no sucesso:

| Valor do enum              | Descrição localizada (em inglês)                                                                               |
| -------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `unknown`                  | Tente novamente                                                                                                |
| `tooMuchMovement` (legado) | Fique imóvel                                                                                                   |
| `tooBright` (legado)       | Vá para um local mais escuro                                                                                   |
| `tooDark` (legado)         | Vá para um local mais claro                                                                                    |
| `misalignedFace` (legado)  | Mantenha seu rosto dentro do oval                                                                              |
| `faceTooFar` (legado)      | Aproxime seu rosto da tela                                                                                     |
| `faceTooClose` (legado)    | Afaste seu rosto da tela                                                                                       |
| `sunglasses` (legado)      | Remova os óculos de sol                                                                                        |
| `systemError`              | Erro do sistema                                                                                                |
| `rejected`                 | A transação não pôde ser concluída                                                                             |
| `faceNotFound`             | Alinhe seu rosto no oval e então tente ficar imóvel                                                            |
| `obscuredFace`             | Certifique-se de que todo o seu rosto esteja visível e remova quaisquer acessórios que possam cobrir seu rosto |
| `timeout`                  | Tempo limite do sistema                                                                                        |
| `eyewear`                  | Remova seus óculos                                                                                             |
| `multipleFaces`            | Certifique-se de que apenas uma pessoa esteja visível                                                          |
| `eyesClosed`               | Certifique-se de que seus olhos estejam abertos                                                                |
| `userNotFound`             | A transação não pôde ser concluída                                                                             |
| `lightingIssues`           | Certifique-se de que seu rosto esteja bem iluminado e sem reflexos                                             |
| `framesBlurry`             | Alinhe seu rosto no oval e então tente ficar imóvel                                                            |
| `deviceIssue`              | Tente usar outro dispositivo                                                                                   |
| `motionIssue`              | Alinhe seu rosto no oval e então tente ficar imóvel                                                            |
| `backgroundIssue`          | Vá para outro local com um fundo neutro                                                                        |
| `deviceRestart`            | Reinicie seu dispositivo e tente novamente                                                                     |
| `processingFault`          | Tente novamente                                                                                                |

Os valores marcados como legado são mantidos por compatibilidade, mas as versões atuais não os retornam mais. Consulte [Tipos legados](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/tratamento-de-falhas/mobile/failure-handling.md#legacy-types) para o equivalente atual de cada um.

{% hint style="info" %}
O `descrição` carrega o texto localizado do mecanismo de liveness para esse motivo. Não o exiba como está: mapeie o `tipo` para a mensagem recomendada em [Motivos da falha e orientação ao usuário](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/tratamento-de-falhas/mobile/failure-handling.md), que foi escrita para orientar a próxima tentativa sem revelar o que foi detectado.
{% endhint %}

## Próximo passo

Encaminhe o `signedResponse` para o seu backend, que o valida e obtém o resultado: [Configuração do backend](https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/configuracao/backend/setup.md).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.caf.io/sdk-lite/sdk-lite-english-pt-br/configuracao/ios/result-reference.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
