> ## Documentation Index
> Fetch the complete documentation index at: https://docs-platform.services-valid.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Instalação
> Carregue o LivenessFacetecSDK Web via CDN com uma única tag de script
O `LivenessFacetecSDK` Web é distribuído **exclusivamente via CDN**. Você adiciona **uma única tag** `
```
## Verificando o carregamento
Depois do carregamento, o objeto `LivenessFacetecSDK` está disponível globalmente:
```javascript theme={"theme":"catppuccin-latte"}
if (typeof window.LivenessFacetecSDK !== 'undefined') {
console.log('LivenessFacetecSDK carregado:', window.LivenessFacetecSDK.SDK_VERSION);
} else {
console.error('Falha ao carregar o SDK');
}
```
## Estrutura HTML mínima
```html theme={"theme":"catppuccin-latte"}
```
O elemento `#camera-container` é onde o SDK renderiza a UI do FaceTec.
## Backend obrigatório
O SDK **não embarca a `x-api-key`**. Você precisa expor um endpoint no seu backend que chame `POST /api/v1/sessions` na Plataforma ID e devolva apenas os tokens de sessão ao cliente.
**Nunca exponha a `x-api-key` no navegador.** Mesmo ofuscada, qualquer chave embarcada no bundle JS pode ser extraída por DevTools. Veja [Serviço](/plataforma/liveness/facetec/servico) para o fluxo recomendado.
Exemplo mínimo (Node.js / Express):
```javascript theme={"theme":"catppuccin-latte"}
import crypto from 'node:crypto';
import express from 'express';
const app = express();
app.use(express.json());
app.post('/api/create-session', async (req, res) => {
const { visitorId, eventId, maxAttempts } = req.body;
const r = await fetch('https://facetec.hub-liveness-service.app/api/v1/sessions', {
method: 'POST',
headers: {
'x-api-key': process.env.PLATFORM_ID_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
clientRequestId: crypto.randomUUID(),
visitorId,
eventId,
maxAttempts, // opcional — número máximo de capturas na sessão (1–5, default 3)
}),
});
if (!r.ok) return res.status(r.status).json(await r.json());
const session = await r.json();
res.json({
sessionId: session.sessionId,
sessionToken: session.sessionToken,
facetecSessionToken: session.facetecSessionToken,
});
});
app.listen(8080);
```
## Próximos passos
Inicialize o SDK e dispare uma verificação de liveness
Personalize cores, textos e idioma da UI
Hierarquia de erros e diagnóstico
Contrato HTTP do backend que emite os tokens