Cria um link de afiliado
Cria um novo link de rastreamento para o afiliado. Se o token for omitido, é gerado um identificador aleatório de 8 caracteres; o token é único globalmente. A URL de destino, quando informada, deve pertencer a um domínio na whitelist da organização. Emite o evento link.created.
Authorizations
Chave de API (prefixo rstr_) enviada como Authorization: Bearer rstr_....
Path Parameters
Identificador do afiliado (prefixo aff_).
^aff_[0-9A-HJKMNP-TV-Z]{26}$"aff_01J9Z3K7Qn8vYwT2bX4cE6dF8g"
Body
Token do link (3-50 caracteres: letras, números e hífens), normalizado para minúsculas. Único globalmente. Se omitido, é gerado um identificador aleatório de 8 caracteres [a-z0-9].
^[a-z0-9-]{3,50}$"maria-silva"
Identificador livre de subcampanha/origem usado para segmentar tráfego e relatórios. Opcional.
1 - 120"instagram-bio"
URL de destino do redirecionamento. Deve pertencer a um domínio na whitelist da organização. Se omitida, usa o destino padrão do programa.
"https://loja.exemplo.com/produto"
Response
Default Response
Identificador único do link (prefixo link_).
"link_01J9Z3K7Qn8vYwT2bX4cE6dF8g"
Identificador da organização dona do link.
"org_01J9Z3K7Qn8vYwT2bX4cE6dF8g"
Identificador do programa ao qual o link pertence.
"prog_01J9Z3K7Qn8vYwT2bX4cE6dF8g"
Identificador do afiliado dono do link.
"aff_01J9Z3K7Qn8vYwT2bX4cE6dF8g"
Token público do link (em minúsculas), único globalmente.
"maria-silva"
Identificador de subcampanha/origem, ou null se não definido.
"instagram-bio"
URL de destino do redirecionamento, ou null quando usa o destino padrão do programa.
"https://loja.exemplo.com/produto"
Indica se este é o link padrão do afiliado (gerado automaticamente).
Situação do link. active: aceita cliques e redireciona. inactive: desativado, não redireciona (token segue reservado por 12 meses).
active, inactive "active"
Data/hora (ISO-8601) em que o link foi desativado, ou null se ativo.
"2026-06-13T12:00:00.000Z"
Data/hora (ISO-8601) de criação do link.
"2026-06-13T12:00:00.000Z"
Data/hora (ISO-8601) da última atualização do link.
"2026-06-13T12:00:00.000Z"
URL pública e clicável do link ({domínio}/t/{token}), já no domínio próprio/primário da organização quando configurado. null/ausente quando a API não tem um domínio base — o cliente usa o fallback local.
"https://go.userepass.com/t/maria-silva"