Taqlyn Logo
TAQLYNSPEC
Universal Links Engine
v1.4.2 · Verified
Console
Taqlyn Docs/REST APIs/Edge Routing & Well-Known API
API v1.42 min read

Edge Routing & Well-Known API

High-speed edge routing lookup, click recording, and dynamic AASA & AssetLinks delivery.

LIVE SPECIMEN
Universal & Deferred Link Simulator
URLhttps://taqlyn.com/shop/checkout?cartId=cart_9841&promo=WELCOME20&aff=partner_8
Route: /shop/checkoutMode: Deferred Install

The Edge Routing API serves sub-millisecond lookup and OS verification files. It powers global CDN and Anycast edge locations without hitting primary database infrastructure.

#Well-Known Verification Files

GET /v1/edge/well-known?kind={kind}&host={host}

Dynamically serves Apple App Site Association and Android Digital Asset Links files tailored to your configured custom domain.

#Parameters

  • kind: Either "apple" (apple-app-site-association) or "android" (assetlinks.json).
  • host: The requested hostname (e.g. links.brand.com or taqlyn.com).

#Apple App Site Association (kind=apple)

JSON
{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "9JA89QZ22A.com.acme.storefront",
        "paths": ["NOT /auth/*", "/*"]
      }
    ]
  }
}

Served with Content-Type: application/json and no redirect.

JSON
[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.acme.storefront",
      "sha256_cert_fingerprints": [
        "14:6D:E9:01:07:52:68:4E:94:52:83:84:B4:95:91:93:17:CD:7A:B3:26:99:F3:7A:0E:96:37:A6:5B:3A:47:86"
      ]
    }
  }
]

#Edge Lookup

GET /v1/edge/lookup?host={host}&code={code}

Unsigned, ultra-low latency routing resolver called by Edge Workers / Cloudflare / Fastly.

#Response (200 OK)

JSON
{
  "linkId": "sl_9128abef",
  "appId": "app_live_8f92ab140cd3",
  "mode": "deferred_app",
  "destinationWeb": "https://example.com/products/491?promo=SUMMER",
  "destinationPath": "/products/491",
  "params": {
    "sku": "491",
    "promo": "SUMMER"
  },
  "og": {
    "title": "Special Summer Offer",
    "description": "Get 20% off with exclusive in-app savings."
  }
}

#Edge Record Click

POST /v1/edge/record-click

Invoked asynchronously when an end-user navigates to a short link. Issues an ephemeral deferred matching ticket stored in the distributed edge cache.

#Request Body

JSON
{
  "linkId": "sl_9128abef",
  "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_4 like Mac OS X)...",
  "ipAddress": "198.51.100.42",
  "acceptLanguage": "en-US,en;q=0.9"
}

#Response (200 OK)

JSON
{
  "clickId": "clk_82f10ca981beef",
  "expiresAt": 1725541200,
  "redirectUrl": "https://apps.apple.com/app/id123456789"
}