Forstify Deep Links

Overview

• Measurement link: your app opens Forstify with a new measurement whose values are already filled in.
• Share with app: the user sends a summary of one or more measurements from Forstify to your app as a .forstify file.

Both work on the device and offline. For synced data on your server, use the External API.

Quick start

Open this page on a phone or tablet with Forstify installed and tap a button. Each one starts a new measurement with example values.

https://app.forstify.de/measure?method=sectional&species=fi&quality=b&logLength=4&reductionFactor=0.95&conversionFactor=0.7&number=P-101&note=MyForestApp&forestOwner=Gemeinde%20Musterdorf&forester=M.%20Muster&serviceProvider=Forst%20GmbH&buyer=S%C3%A4gewerk%20Nord&hiebsNumber=H-7&lotNumber=L-12&areaNumber=4711&division=12&subdivision=b&inventoryUnit=IE-3

https://app.forstify.de/measure?method=logpile&species=ki&quality=c&logLength=5&number=P-102&note=MyForestApp&buyer=Holzhandel%20S%C3%BCd&lotNumber=L-20

https://app.forstify.de/measure?method=single_log_form&species=ei&quality=a&logLength=8.5&number=P-103&note=MyForestApp&forestOwner=Privatwald%20Huber&division=3

What the app does

Checks

Rules

• Every value stays visible and can be changed by the user.
• Every parameter is optional and checked on its own. An invalid value is skipped, the rest still applies, and the app shows a short notice naming the skipped parameters. Unknown parameters are ignored.
• Parameters the chosen method does not use are ignored.
• One link starts one measurement.

Measurement link

Parameters

Query parameters of /measure. URL-encode every value. Decimals use a point (4.5, not 4,5) and at most two decimals. Codes are case-insensitive, except method.

Methods

Logpile number, note, species and the "further details" fields are filled in for every method. Sortiment and Sorte are set by the user.

The same codes are used for method in the shared file. A photo analysis comes back as logpile: it saves the same kind of measurement.

Examples

// Opens Forstify with a prefilled measurement. Android hands the link to the app (App Link) or to the browser.
val uri = Uri.parse("https://app.forstify.de/measure").buildUpon()
    .appendQueryParameter("method", "sectional")
    .appendQueryParameter("species", "fi")
    .appendQueryParameter("logLength", "4")
    .appendQueryParameter("number", "P-123")
    .appendQueryParameter("note", "MyForestApp")
    .build()

startActivity(Intent(Intent.ACTION_VIEW, uri))

// Opens Forstify with a prefilled measurement. iOS hands the link to the app (Universal Link) or to Safari.
var components = URLComponents(string: "https://app.forstify.de/measure")!
components.queryItems = [
    URLQueryItem(name: "method", value: "sectional"),
    URLQueryItem(name: "species", value: "fi"),
    URLQueryItem(name: "logLength", value: "4"),
    URLQueryItem(name: "number", value: "P-123"),
    URLQueryItem(name: "note", value: "MyForestApp"),
]

if let url = components.url {
    UIApplication.shared.open(url)
}

// Web app or PWA on the phone: a normal link.
// Android and iOS open it in Forstify when it is installed.
// Open it from a user action (link or button tap).
const params = new URLSearchParams({
  method: 'sectional',
  species: 'fi',
  logLength: '4',
  number: 'P-123',
  note: 'MyForestApp',
});

const link = document.querySelector<HTMLAnchorElement>('#measure-in-forstify')!;
link.href = `https://app.forstify.de/measure?${params}`;

Share with app

How users share

In Forstify, the user opens the export of one measurement (or selects several in the list) and taps Share with app (DE: Mit App teilen). The system share dialog opens with the file.

To appear in that dialog, your app registers for the file type as shown below.

Receive on Android

Forstify sends an ACTION_SEND intent with the MIME type above and the file as a content:// URI in EXTRA_STREAM, with read permission granted. Add an intent filter for that MIME type:

<activity android:name=".ForstifyImportActivity" android:exported="true">
  <intent-filter>
    <action android:name="android.intent.action.SEND" />
    <category android:name="android.intent.category.DEFAULT" />
    <data android:mimeType="application/vnd.forstify.measurements+json" />
  </intent-filter>
</activity>

class ForstifyImportActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val uri = IntentCompat.getParcelableExtra(intent, Intent.EXTRA_STREAM, Uri::class.java)
        val json = uri?.let { contentResolver.openInputStream(it)?.bufferedReader()?.use { reader -> reader.readText() } }
        val file = json?.let { JSONObject(it) }
        if (file == null || file.optString("format") != "forstify.measurements" || file.optInt("version") != 1) {
            finish()
            return
        }
        val measurements = file.getJSONArray("measurements")
        for (i in 0 until measurements.length()) {
            val measurement = measurements.getJSONObject(i)
            val note = measurement.optString("note")          // your reference, if you sent one
            val fm = measurement.getJSONObject("volume").optDouble("fm")
            // …
        }
    }
}

// The receiving code for iOS is under "Receive on iOS".

// A web app cannot register for a file type on the phone;
// receiving the file needs a native app.

Receive on iOS

Forstify declares the type de.forstify.measurements. Import the type and declare that your app opens it; the share sheet then lists your app for .forstify files. Add to Info.plist:

<key>UTImportedTypeDeclarations</key>
<array>
  <dict>
    <key>UTTypeIdentifier</key><string>de.forstify.measurements</string>
    <key>UTTypeDescription</key><string>Forstify Measurements</string>
    <key>UTTypeConformsTo</key><array><string>public.json</string></array>
    <key>UTTypeTagSpecification</key>
    <dict>
      <key>public.filename-extension</key><array><string>forstify</string></array>
      <key>public.mime-type</key><array><string>application/vnd.forstify.measurements+json</string></array>
    </dict>
  </dict>
</array>
<key>CFBundleDocumentTypes</key>
<array>
  <dict>
    <key>CFBundleTypeName</key><string>Forstify Measurements</string>
    <key>CFBundleTypeRole</key><string>Viewer</string>
    <key>LSHandlerRank</key><string>Alternate</string>
    <key>LSItemContentTypes</key><array><string>de.forstify.measurements</string></array>
  </dict>
</array>
<key>LSSupportsOpeningDocumentsInPlace</key><false/>

// The receiving code for Android is under "Receive on Android".

struct ForstifyShareFile: Decodable {
    let format: String
    let version: Int
    let exportedAt: String
    let measurements: [ForstifyShareMeasurement]
}

struct ForstifyShareMeasurement: Decodable {
    struct Volume: Decodable { let fm: Double?; let rm: Double? }
    let id: String?
    let method: String?
    let number: String?
    let note: String?
    let species: [String]
    let volume: Volume
    let logCount: Int?
    // … see "File format"
}

// SceneDelegate: iOS copies the shared file into the app's Inbox and opens it here.
func scene(_ scene: UIScene, openURLContexts contexts: Set<UIOpenURLContext>) {
    guard let url = contexts.first?.url, url.pathExtension == "forstify" else { return }
    defer { try? FileManager.default.removeItem(at: url) }
    guard let data = try? Data(contentsOf: url),
          let file = try? JSONDecoder().decode(ForstifyShareFile.self, from: data),
          file.format == "forstify.measurements", file.version == 1 else { return }
    for measurement in file.measurements {
        // measurement.note is your reference, if you sent one
    }
}

// A web app cannot register for a file type on the phone;
// receiving the file needs a native app.

File format

ForstifyShareFile

ForstifyShareMeasurement

A value that does not apply to the method is null, never left out. Lists are always arrays, possibly empty.

Example file

{
  "format": "forstify.measurements",
  "version": 1,
  "exportedAt": "2026-10-15T09:12:44.000Z",
  "measurements": [
    {
      "id": "6f1d7c2e-3a41-4f4b-9a7e-1b2c3d4e5f60",
      "serverId": null,
      "createdAt": "2026-10-15T08:57:10.000Z",
      "method": "logpile",
      "number": "P-124",
      "note": "MyForestApp",
      "species": ["ki"],
      "assortment": ["Stammholz"],
      "variety": ["Abschnitte"],
      "quality": { "min": "bc", "max": "bc" },
      "volume": { "fm": 12.416, "rm": null },
      "logCount": 38,
      "logLength": { "avg": 5, "min": 5, "max": 5 },
      "diameter": { "min": 18.5, "max": 41.2 },
      "diameterClasses": [
        { "class": "1b2", "logCount": 4, "fm": 0.612 },
        { "class": "2a", "logCount": 11, "fm": 2.144 },
        { "class": "2b", "logCount": 12, "fm": 3.561 },
        { "class": "3a", "logCount": 8, "fm": 3.398 },
        { "class": "4a", "logCount": 3, "fm": 2.701 }
      ],
      "factors": null,
      "location": { "lat": 50.12345, "lng": 8.54321 },
      "metadata": {
        "forestOwner": "Gemeinde Musterdorf", "forester": null, "serviceProvider": null, "buyer": null, "hiebsNumber": null,
        "lotNumber": "7", "areaNumber": null, "division": null, "subdivision": null, "inventoryUnit": null
      }
    }
  ]
}

Versioning

• The file carries format and version (1). A change that removes or reshapes a field gets a new file version.
• New link parameters and new file fields can be added at any time. Ignore fields you do not know.
• New enum values (e.g. species) can appear at any time. Handle unknown codes, e.g. by showing the code.

Enum reference

WoodSpecies, full list

All 183 values accepted for species in the link and used in the file. Codes are lowercase (the link also accepts uppercase).