SDK API

POST /v1/deeplink

Resolve an App Link or Universal Link open into its deep link.

POST https://attribution.ondropp.app/v1/deeplink
Content-Type: application/json
X-Key-Id: ak_3f9c1e2a7b6d4c80
X-Timestamp: 1760700000
X-Signature: <signature>

When your app is installed, App Links and Universal Links open it directly and Dropplink's redirect never runs. Send the URL the app was opened with, signed like /v1/init. Dropplink records the open as a tap and returns the link's deep link. The SDK's handleDeepLink makes this call for you.

Request#

Request body

{ "installId": "6f1c2a9e-3b7d-4c51-9a8e-2d4f6b1c0e73", "url": "https://go.yourbrand.com/diwali?s=ig&variant=blue" }

Field	Rules
`installId`	The install's UUID, the same one sent to `/v1/init`.
`url`	The opened URL. `http` or `https`, up to 2,048 characters.

Response#

200 OK

{ "clickId": "c_3d9a0b1c2e4f6a8b", "deepLink": { "path": "/product/123", "params": { "variant": "blue", "ref": "story" } } }

Field	Meaning
`clickId`	The tap recorded for this open. `null` if the URL isn't one of this app's links: another domain, or an unknown or expired code.
`deepLink`	The link's path and parameters. `params` are the link's own, overridden by the URL's query, except `s` and `utm_*`. `null` if the link has no deep link path, or the URL isn't one of your links.

Opens are recorded with via: app_link and don't change the install's attribution. Sending the same open again within 30 minutes returns the same clickId and isn't counted twice.

Errors are the same as for /v1/init, with 400 validation_failed for a bad installId or url.