Deep-Link-URI für Mobile-Apps
Bauen Sie einen Link, der Ihre App statt des Browsers öffnet: Scheme myapp, Host product und Pfad /item/42 ergeben myapp://product/item/42, die Query-Paare werden nach dem Fragezeichen kodiert. Unzulässige Zeichen im Scheme werden gestoppt. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Läuft direkt in Ihrem Browser – kostenlos. Ihre Datei verlässt Ihren Browser nicht und wird an keinen Server übertragen.
Mobile Apps öffnen Inhalte über benutzerdefinierte URL-Schemes wie myapp://product/item/42? Von Hand gebaute Zeichenketten driften ab—Leerzeichen im Scheme, unescapte Ampersands, fehlende Schrägstriche—und brechen Open-in-App-Abläufe auf iOS und Android.
Was ein Deep Link mit Custom-Scheme ist und wie die URI zusammengesetzt wird
Ein mobiler Deep Link mit Custom-Scheme ist eine URI, die das Betriebssystem an Ihre installierte App statt an den Browser weiterleitet. Das Scheme ist das Token vor Doppelpunkt und Doppel-Schrägstrich—myapp, com.example.app oder my-app+v2—und muss der URI-Scheme-Grammatik folgen: zuerst ein Buchstabe, dann nur Buchstaben, Ziffern, Plus, Punkt oder Bindestrich. Leerzeichen, Unterstriche, Doppelpunkte und Schrägstriche im Scheme sind unzulässig und die häufigsten Copy-Paste-Fehler, wenn ein Produktname unbereinigt als Scheme verwendet wird.
Nach scheme:// folgt ein optionaler Host (manchmal Authority genannt), etwa product, open oder auth, dann ein optionaler Path wie /item/42, dann eine optionale Query-Zeichenkette aus Schlüssel-gleich-Wert-Paaren, verbunden durch Ampersands. Dieser Builder verkettet diese Teile in fester Reihenfolge: Scheme, Literal ://, Host (darf leer sein), ein Path, der bei Nichtleerheit immer einen einzelnen führenden Schrägstrich erhält, und eine Query-Zeichenkette nur wenn mindestens ein Parameter vorhanden ist.
Query-Schlüssel und -Werte werden percent-encodiert mit denselben Regeln, die Browser für Komponenten im Stil application/x-www-form-urlencoded nutzen, sodass Leerzeichen zu Escapes im Stil %20 werden und reservierte Zeichen die Query nicht zerteilen können. Wenn der Host leer ist und der Path /promo lautet, sieht das Ergebnis aus wie myapp:///promo; wenn Host und Path leer sind, erhalten Sie dennoch eine legale scheme://-Hülle, nützlich als bare Open-App-Intent.
Wo ein Deep-Link-URI-Builder seinen Nutzen zeigt
Growth- und CRM-Pipelines erzeugen personalisierte Open-in-App-Links für jede Kampagne, ohne dass Ingenieure Percent-Encoding neu implementieren müssen. QR- und Packaging-Tools brauchen eine stabile Zeichenkette zum Drucken; die Scheme-Validierung im Voraus verhindert einen Produktions-Recall, wenn jemand My App! als Scheme einfügt.
Multi-Tenant-White-Label-Apps mappen jede Marke auf ihr eigenes Scheme-Token und teilen dennoch einen Builder für Path- und Query-Konventionen. Fehlgeschlagene Validierung wird nicht abgerechnet. Halten Sie Schemes in einer dokumentierten Allow-List auf Ihrer Seite, lehnen Sie hier illegale Zeichen ab, und Sie erhalten reproduzierbare Deep Links für SMS, E-Mail, Anzeigen und In-App-Shares, ohne einen Link-Shortener oder einen Attribution-Stack allein für URI-Zusammenbau aufzubauen.
Häufige Fragen
Welche Scheme-Zeichen sind erlaubt?
RFC 3986: zuerst ein Buchstabe, dann nur Buchstaben, Ziffern, Plus (+), Punkt (.) oder Bindestrich (-).
Wie sieht der Link ohne Host aus?
Mit leerem Host und dem Pfad /promo wird daraus myapp:///promo, mit drei Schrägstrichen. Sind Host und Pfad beide leer, erhalten Sie trotzdem einen gültigen Link wie myapp://, der einfach die App öffnet.
Was passiert mit Leerzeichen und Sonderzeichen in der Query?
Jeder Schlüssel und jeder Wert wird nach denselben Regeln kodiert, die Browser für Formulare verwenden. Ein Leerzeichen wird so zur Escape-Folge, und ein kaufmännisches Und kann die Query nicht in falsche Paare zerlegen.
Wie viele Query-Paare darf ein Link enthalten?
Bis zu 50. Jeder Schlüssel muss nach dem Entfernen äußerer Leerzeichen noch Text enthalten, Werte dürfen Text, Zahlen oder wahr und falsch sein und werden vor dem Kodieren in Text umgewandelt.
Warum steht vor dem Pfad ein Schrägstrich?
Weil ein nicht leerer Pfad immer genau einen führenden Schrägstrich bekommt: item/42 und /item/42 ergeben denselben Link. So bleibt das Ergebnis vorhersehbar, egal wie der Pfad eingegeben wurde.
Verwandte Tools
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/web/deep-link-scheme-build \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"scheme":"myapp"}'const res = await fetch("https://api.kit.forhosting.com/web/deep-link-scheme-build", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"scheme": "myapp"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/web/deep-link-scheme-build",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"scheme": "myapp"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/deep-link-scheme-build", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"scheme":"myapp"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"scheme":"myapp"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/deep-link-scheme-build", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"scheme": "myapp"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "web.deep_link_scheme_build",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Limits
timeout_sec | 30 |
max_crawl_pages | 25 |
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |
Technische Hinweise
ref=email. Produkt-, Growth- und Engineering-Teams brauchen, dass diese Deep-Link-URIs jedes Mal wohlgeformt sind: ein legales Scheme-Token, ein vorhersehbarer Host und Path sowie percent-encodierte Query-Paare, die Copy-Paste in Push-Payloads, SMS, QR-Codes und Anzeigenziele überstehen. Diese Fähigkeit akzeptiert ein benutzerdefiniertes Scheme, optionalen Host, optionalen Path und eine optionale Liste von Query-Schlüssel/Wert-Paaren, prüft das Scheme gegen die RFC-3986-Produktion, normalisiert den Path, encodiert die Query und liefert die fertige deep_link-Zeichenkette plus strukturierte Echo-Felder. Ungültige Scheme-Zeichen scheitern mit invalid_input statt still eine kaputte URI auszugeben.
Was ein Deep Link mit Custom-Scheme ist und wie die URI zusammengesetzt wird
Die Antwort spiegelt scheme, host, path, query_params, query_string, deep_link und has_query, damit Clients strukturierte Teile protokollieren können, ohne die URI erneut zu parsen. Weil der Algorithmus rein und deterministisch ist, liefern dieselben Eingaben immer denselben deep_link byte für byte auf dem kostenlosen Browser-Pfad und dem bezahlten API-Pfad.
Eingabevertrag, Validierungsregeln und Fehlerverhalten
Höchstens fünfzig Paare werden akzeptiert. Jeder key muss nach dem Trim nicht leer sein; Werte dürfen Zeichenketten, Zahlen oder Booleans sein und werden vor dem Encodieren in Zeichenketten umgewandelt. Senden Sie per POST einen JSON-Body mit scheme als einzigem strikt erforderlichen Feld: eine nach dem Trim nicht leere Zeichenkette, die dem Muster Buchstabe, dann Buchstaben, Ziffern, Plus, Punkt oder Bindestrich entspricht. Die Aliasse url_scheme, custom_scheme und protocol werden akzeptiert. host ist optional und standardmäßig die leere Zeichenkette; wenn gesetzt, darf es keine Leerzeichen, Schrägstriche, Fragezeichen oder Rauten enthalten. path ist optional; wenn nicht leer, darf es keine Leerzeichen, Fragezeichen oder Rauten enthalten, und ein führender Schrägstrich wird eingefügt, wenn Sie ihn weglassen, sodass item/42 zu /item/42 wird. query_params ist ein optionales Array von Objekten, jeweils mit erforderlichem key und optionalem value (Standard leere Zeichenkette); die Aliasse query, params und search_params funktionieren gleich. Fehlendes oder leeres scheme, scheme mit ungültigen Zeichen, illegale Host- oder Path-Zeichen, query_params, das kein Array ist, oder leere keys scheitern mit invalid_input und einer klaren Meldung, die das Problem benennt—diese Fehler werden nicht abgerechnet. Bei Erfolg erhalten Sie normalisierte scheme, host und path; die normalisierte query_params-Liste; query_string ohne führendes Fragezeichen; deep_link als vollständige URI; und has_query als Boolean. Beispiel: scheme myapp, host product, path /item/42 und query_params ref gleich email plus utm_source gleich newsletter ergibt myapp://product/item/42? ref=email&utm_source=newsletter. Koppeln Sie deep_link mit den Associated Domains oder Intent-Filtern Ihrer App auf dem Client; dieser Endpunkt baut nur die URI-Zeichenkette und registriert keine Schemes beim OS und prüft nicht, ob die App installiert ist.
Wo ein Deep-Link-URI-Builder seinen Nutzen zeigt
Push-Notification-Backends setzen Scheme, Screen-Host und Entity-Id zu einem einzigen deep_link-Feld zusammen, das der Mobile-Client beim Cold Start parsen kann.
Integrationsbeispiele
Kampagnen- und CRM-Open-in-App-Links
Erstellen Sie personalisierte myapp://host/path?utm…-Deep-Links für E-Mail, SMS und Anzeigen aus einem validierten Scheme und einer Query-Map.
Ziele im Push-Notification-Payload
Setzen Sie Scheme, Screen-Host und Entity-Path zu einer einzigen deep_link-Zeichenkette zusammen, die der Mobile-Client beim Tippen auf die Benachrichtigung öffnet.
QR, Packaging und QA-Goldens
Erzeugen Sie druckbare Deep-Link-URIs und pinnen Sie byte-stabile deep_link-Werte in Tests, damit illegale Schemes nie ausgeliefert werden.
Technische Fragen
Wie erstelle ich eine Deep-Link-URI für eine Mobile-App?
Senden Sie ein benutzerdefiniertes Scheme (erforderlich), optionalen Host und Path sowie optionale query_params als {key, value}-Paare. Die API liefert deep_link als scheme://host/path?query mit percent-encodierten Parametern.
Was passiert, wenn das Scheme ungültige Zeichen hat?
Die Aufgabe scheitert mit invalid_input und einer Meldung, die das ungültige Scheme benennt. Es wird kein deep_link zurückgegeben und der Aufruf wird nicht abgerechnet.
Sind Host oder Path erforderlich?
Nein. Beide sind standardmäßig leer. Sie können scheme:// allein, scheme://host, scheme:///path oder die volle Form scheme://host/path?query ausgeben.
Was kostet der Deep-Link-URI-Builder?
Das Browser-Tool ist kostenlos. API-Anfragen nutzen vorausbezahltes KIT-Guthaben zu $0.002 pro erfolgreichem Aufruf; ungültige Eingabe wird nicht abgerechnet.