Parceiros

Exemplo completo: integração de parceiro

Este guia mostra um fluxo típico para integrar a nossa API de parceiros em um sistema próprio.

1. Quando chamar a API

  1. O usuário se cadastra no sistema do parceiro.
  2. O parceiro valida o e-mail do usuário.
  3. Após a validação, o parceiro chama POST /api/v1/partners/create-userpara criar a conta na nossa plataforma.

2. Exemplo de código (TypeScript)

Abaixo um exemplo simplificado de como integrar a chamada em um backend em TypeScript.

async function onUserVerified(user: { email: string; name?: string }) {
    const response = await fetch(
    "https://seu-dominio.com/api/v1/partners/create-user",
    {
        method: "POST",
        headers: {
            "Authorization": `Bearer ${process.env.PARTNER_API_KEY}`,
            "Content-Type": "application/json",
        },
        body: JSON.stringify({
            email: user.email,
            name: user.name,
        }),
    }
    );

    const data = await response.json();

    if (!response.ok) {
        // Log error and handle it in your system
        throw new Error(data.error || "Erro ao criar usuário parceiro");
    }


    // Optionally save data.userId in your database
    return data;
}

3. Tratamento de erros

  • 400: body inválido (por exemplo, sem o campo email).
  • 401: API key ausente ou inválida.

Sempre verifique response.ok antes de confiar na resposta da API.

4. Próximos passos

Para continuar a integração, veja também: