Skip to main content
POST
Solicitar Link Mágico

Visão Geral

Endpoint público (sem autenticação por API key). Sempre responde 200, com maskedEmail = null quando o CPF/CNPJ não corresponde a nenhum cliente — é assim por design, para evitar enumeração de CPFs cadastrados. Quando há cliente correspondente, a Garu envia um e-mail com um link da forma https://garu.com.br/minha-area/<jwt>. O JWT tem TTL de 24h e é reutilizável dentro desse período.

Throttle

3 requisições por hora por IP. Excedente retorna 429 Too Many Requests.

Exemplo de Requisição

Parâmetros

string
required
CPF (11 dígitos) ou CNPJ (14 dígitos). Pontuação é removida no servidor.

Resposta

200 OK sempre, mesmo sem cliente correspondente:
ou
Não tente inferir a existência do CPF pela resposta — o tempo de resposta é constante e o maskedEmail = null cobre tanto “CPF inválido” quanto “CPF não cadastrado”.

Erros

  • 400 Bad Request — corpo inválido (ex: document ausente).
  • 429 Too Many Requests — throttle de 3/hora/IP excedido.