# As integrações do seu produto, sem construir nenhuma

> Se o seu produto precisa dos dados dos seus clientes, use a API da Erathos por trás. Você conecta as fontes de cada cliente pelo código, a Erathos extrai e carrega, e os dados chegam no banco do seu produto prontos para ele usar.

Source: https://www.erathos.com/embedded

## Cada cliente conecta as próprias fontes, dentro do seu produto

Todas as conexões ficam num workspace só, o do seu produto. Para cada cliente, o seu código cria a conexão pela API com o nome que fizer sentido para você, como o ID do cliente.

As credenciais chegam pela interface do seu produto e seguem para a Erathos pela API. Nas fontes com OAuth, a API devolve um link de autorização de uso único: o cliente autoriza e volta para o seu produto com o resultado.

### Uma conexão por cliente

Crie a conexão de cada cliente pela API, no mesmo workspace, e identifique cada uma pelo seu próprio ID.

### Credenciais pelo seu produto

O cliente informa as credenciais na sua interface, e o seu código as envia pela API. Fontes com OAuth também são suportadas.

### OAuth de volta ao seu produto

Nas fontes com OAuth, a API gera um link de autorização válido por 30 minutos e de uso único, que devolve o cliente ao seu produto com o status.

## Configure e acompanhe cada cliente sem abrir a plataforma

O seu produto escolhe tabelas e endpoints, a frequência e o tipo de atualização de cada conexão pela API, com uma prévia antes de salvar.

Cada conexão informa em que passo do setup está, e cada run pode ser disparado e acompanhado pela mesma API. O seu código sempre sabe o que fazer em seguida.

### Jobs com prévia

Veja o que vai ser sincronizado antes de salvar, e salve com dry_run: false.

### Status do setup

setup_status diz se a conexão espera credenciais, precisa de configuração ou já está pronta para os jobs.

### Runs pela API

Dispare runs quando o seu produto precisar e acompanhe o status de cada um.

## O seu produto sabe quando os dados de cada cliente chegaram

Os dados de todas as conexões chegam no destino do workspace: o banco de dados que o seu produto já usa, como PostgreSQL, Supabase ou SQL Server, ou um warehouse, se for o caso.

Depois de cada run, um webhook, criado pela própria API, avisa o seu sistema com os detalhes da execução. Regras definem quando ele dispara, por exemplo só em runs que terminaram com sucesso e trouxeram linhas novas.

### Um destino, o seu

Todas as conexões carregam no banco do seu produto, de onde ele já lê.

### Webhook a cada run

O seu sistema recebe uma requisição depois de cada run, com status, linhas e o job que rodou.

### Regras para disparar

Dispare só quando importa, como em runs com sucesso que carregaram linhas.

## Dúvidas Frequentes

### Cada cliente meu precisa de uma conta na Erathos?

Não. O seu produto usa um workspace, e cada cliente vira uma conexão dentro dele. As credenciais chegam pela sua interface e seguem pela API, e nas fontes com OAuth o cliente autoriza por um link que o devolve ao seu produto.

### Para onde vão os dados?

Para o destino do workspace: o banco de dados que o seu produto já usa, como PostgreSQL, Supabase ou SQL Server, ou um warehouse. Fale com a gente para desenhar como os dados de cada cliente ficam organizados nele.

### Quais fontes eu posso oferecer aos meus clientes?

Qualquer uma das mais de 100 fontes do catálogo, de bancos de dados a ferramentas SaaS e ERPs. Para APIs internas ou de nicho, o conector customizado está nos planos Pro e Enterprise.

### Como o meu produto se autentica na API?

Com uma chave de API da Erathos, enviada no header Authorization. A chave age como o usuário dono dela: cada pedido só pode fazer o que esse usuário já pode fazer no workspace. O passo a passo está na [documentação da API](https://docs.erathos.com/api/introduction/set-up-connections).

### Como funciona o preço?

Depende do volume de dados e de quantos clientes o seu produto vai conectar. Fale com vendas para montar o plano certo.