Deferred-match resolution from Android Play Install Referrer

Deferred-match resolution from Android Play Install Referrer (deterministic).

THE CALL, PART BY PART

method

POST

host

strait.link

version

/v1

resource

/referrer

POST /v1/referrer

Auth: publishable key as publishableKey in the JSON body. Safe in apps and websites.

Request

Body (JSON)

publishableKey required string
linkId required string
strait_link value from the referrer
platform string
appVersion string
The app's own version (iOS CFBundleShortVersionString, Android versionName), kept on the open. 1-64 printable ASCII characters; anything else is ignored, never an error.
sdkVersion string
The Strait SDK version, kept on the open. Same rule as appVersion.
installReferrer string
Android: the raw Google Play install referrer string (InstallReferrerClient). Only its utm_source / utm_medium / utm_campaign / utm_term / utm_content are kept on the install (each decoded, trimmed, at most 100 characters); everything else (gclid, strait_link…) is dropped, never stored. Over 4096 characters or not a string: ignored, never an error. Listed in GET /v1/export?part=installs.
record boolean
false = a read only (SDK checkDeferred): answer the match, record no install, open or webhook. Omit for the real first-launch check.

Response

  • 200 Match result
  • 401 Missing or invalid publishable key
Request · curl
curl -X POST https://strait.link/v1/referrer \
  -H "Content-Type: application/json" \
  -d '{
    "publishableKey": "st_pub_live_…",
    "linkId": "lnk_5f0c2a8e-3b1d-4f6a-9c7e-2d8b1a0e4f63",
    "platform": "android"
  }'

The response, printed

Response 200
{
  "matched": true,
  "longUrl": "https://shop.example.com/sale/summer?utm_source=whatsapp&utm_campaign=summer-2026",
  "linkId": "lnk_5f0c2a8e-3b1d-4f6a-9c7e-2d8b1a0e4f63",
  "matchMethod": "install_referrer",
  "confidence": null,
  "clickId": "9a1c7e52-4b3d-4f8e-a6d1-0c2b5e7f9a34",
  "reasons": [],
  "match": {
    "method": "install_referrer",
    "confidence": "exact"
  }
}