Começando com a API de Parceiros

1. Obter uma API key de parceiro

Entre em contato com o nosso time para receber sua API key de parceiro. Você vai usar essa chave em todas as chamadas para autenticação.

Authorization: Bearer SUA_API_KEY

x-api-key: SUA_API_KEY

2. Criar um usuário final

Use o endpoint POST /api/v1/partners/create-userpara criar (ou reutilizar) uma conta de usuário associada ao seu ID de parceiro.

Exemplo de requisição usando curl:

curl -X POST "https://seu-dominio.com/api/v1/partners/create-user" -H "Authorization: Bearer SUA_API_KEY" -H "Content-Type: application/json" -d '{
"email": "cliente@example.com",
"name": "Cliente Exemplo"
}'

Resposta (exemplo):

{
"ok": true,
"userId": "clx123...",
"email": "cliente@example.com",
"origin": "partner:MEU_PARCEIRO",
"message": "Account created (or already existed) and is active."
}

Importante: você é responsável por validar o e-mail do usuário antes de chamar a API. Nós não enviaremos código de verificação nessa etapa.