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. prisma.referralLink.update({ where: { code }, data: { clicks: { increment: 1 } } }).
2. .catch()-d to a warn log on failure (e.g. unknown code, DB transient issue). Failure does NOT propagate.
3. 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