Track Referral Click

POST /api/v1/referral/click/:code — 🌐 Public · Rate limit: 60 req / minute · Kill-switched

Increments the clicks counter on the ReferralLink row matching code. Public — no auth required (clicks come from landing pages where the visitor isn't signed in yet). Silent on missing/inactive codes: if the code doesn't exist, the database update fails internally, the failure is logged at warn level, and the response is still 200 OK.

Request

Path parameters

No body, no headers required.

Response

200 OK — ApiResponseOf<TrackClickResponseDto>

{
  "success": true,
  "data": {
    "tracked": true
  }
}

Errors

The endpoint does not return 4xx for missing codes — see callout.

Side effects

1. resolveLinkByCode(code) (alias-aware): tries referralLink.findUnique({ where: { code } }) first, then falls back to referralLinkAlias.findUnique({ where: { code }, include: { referralLink: true } }). Returns null if neither matches.
2. No link (neither live code nor alias) → log warn [referral] Click tracking: no link found for code <code> and return without writing anything. Response is still 200 OK { tracked: true }.
3. Link found → prisma.referralLink.update({ where: { id: link.id }, data: { clicks: { increment: 1 } } }). The increment targets the ReferralLink.id returned by the resolver, so a click on bio.re/ref/<oldcode> (alias) and a click on bio.re/ref/<newcode> (live) both increment the same row's clicks counter — no double-counting, and aliases don't carry counters of their own.
4. .catch()-d to a warn log on failure (e.g. DB transient issue). Failure does NOT propagate.
5. Return { tracked: true }.

Code samples

curl -X POST https://api.bio.re/api/v1/referral/click/alice123

async function trackReferralClick(code: string): Promise<void> {
  // Fire-and-forget — landing page navigation should never block on this
  await fetch(`https://api.bio.re/api/v1/referral/click/${encodeURIComponent(code)}`, {
    method: 'POST',
  }).catch(() => { /* swallow — analytics is non-critical */ });
}

<!-- /ref/[code]/page.tsx (Next.js) -->
<script>
  // Extract code from URL: /ref/alice123 → 'alice123'
  const code = window.location.pathname.split('/').filter(Boolean).pop();
  if (code) {
    fetch(`/api/v1/referral/click/${code}`, { method: 'POST' }).catch(() => {});
  }
</script>

Try it

curl -X POST "https://loading/api/v1/referral/click/string"

{
  "success": true,
  "data": {
    "tracked": true
  }
}

Source