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
- O usuário se cadastra no sistema do parceiro.
- O parceiro valida o e-mail do usuário.
- 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: