Skip to content

Developer docs / v1

Forge your
first link.

Go from domain to production-ready mobile route. These examples use LinkForge's HTTP API and control plane.

/01

Quickstart

Start with three things: a configured domain, an app record, and an API key scoped to the target environment.

01

Connect domain

02

Register app

03

Issue SDK key

Use separate keys and app identities for staging and production.
/03

Resolve a link

Resolve from a trusted backend or SDK client. Platform, install state, and policy select the best destination while preserving attribution context.

typescript
const response = await fetch(
  "https://your-domain.com/api/v1/sdk/short-link/resolve",
  {
    method: "POST",
    headers: {
      "x-api-key": process.env.LINKFORGE_API_KEY,
      "content-type": "application/json",
    },
    body: JSON.stringify({ slug: "summer", platform: "ios" }),
  },
);

const { destinationUrl } = await response.json();
  • API keys stay scoped to one environment.
  • Unknown links return a stable 404 contract.
  • Analytics events can be recorded after resolution.
/04

Domain setup

Point your hostname to LinkForge, then configure the iOS Team ID, bundle ID, Android package name, and signing fingerprints. LinkForge generates both association files.

/.well-known/apple-app-site-associationiOS
/.well-known/assetlinks.jsonAndroid
Association files prove configuration. Always finish with a signed-device Universal Link and App Link test.

Next step

Ready to configure?

Open control plane