---
url: https://developers.zarv.com/intro.md
description: >-
  As três formas de integrar com a Zarv (API REST, SDK web e Zarv Agent) e qual
  delas usar em cada projeto.
---

# Introdução

A Zarv é uma plataforma de gerenciamento de riscos. Você integra com ela por três
superfícies, e a maioria dos projetos usa só uma ou duas.

## As três superfícies

### API REST

Duas APIs, cada uma com seu spec OpenAPI e sua base:

* **[Zarv ID](/api/zarv-id/)** (`services.zarv.com`) — verificação de identidade,
  score e blacklist. Autenticação por Bearer JWT.
* **[Collector](/api/collector/)** (`collector.zarv.com`) — ingestão de eventos e
  telemetria.

### SDK web

Um loader único (`js.zarv.com/sdk.js`) que serve o
**[Chat](/sdk/chat)** (widget de conversa) e o
**[Smartflow](/sdk/smartflow)** (funnel de cadastro/KYC embutido). Configuração
por chave pública, sem backend do seu lado.

### Edge Agent

O **[Zarv Agent](/edge-agent/)** roda on-premise, ingere câmeras RTSP/ONVIF e faz
a visão computacional localmente — só eventos relevantes sobem para a nuvem. É
instalação de infraestrutura, não código de integração.

## Credenciais

* **API**: solicite as credenciais ao time da Zarv, indicando qual API você vai
  usar. Cada API tem seu próprio conjunto.
* **SDK**: a chave pública (`pk-<id>`) sai do admin Zarv, na campanha ou no bot
  correspondente.
* **Edge Agent**: a chave de enrollment vem da Zarv no momento do provisionamento.

## Próximos passos

* **[Setup](/setup)** — hosts, autenticação e o essencial da integração. Se você
  usa um agente de código, comece por aqui: basta colar uma URL.
* **[Platform APIs](/api/)** — todos os endpoints, gerados a partir dos specs
  OpenAPI.

Precisa de ajuda? Fale com o time da Zarv ou use o chat no canto da página.