> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# App Deep Link QR Code

> Créez un QR code qui renvoie vers un écran précis d'une application mobile.

## À quoi ça sert

Un QR code App Deep Link ouvre votre application directement sur un écran précis — via son schéma d'URI personnalisé — si l'application est installée sur l'appareil qui scanne. Si elle n'est pas installée, le code se replie sur la fiche de votre application dans la boutique, ou sur une simple page web en dernier recours. C'est un **Quick Code** — un QR à action directe sans page de destination. Dans l'application, la vignette correspondante indique « Open your app directly if it's installed, otherwise fall back to the store ».

<Note>
  App Deep Link est **toujours un QR code dynamique** — cela est nécessaire pour que la logique de résolution (application → boutique → repli) puisse s'exécuter au moment du scan. Vous obtenez une URL courte Scanova (`scnv.io/...`) et pouvez y associer un domaine personnalisé, mais il n'y a pas de page de destination propre.
</Note>

## Ordre de résolution

Le formulaire est organisé en trois sections, vérifiées dans cet ordre au moment du scan :

1. **Application installée** — l'appareil ouvre votre application directement via l'**URI d'application Android** ou l'**URI d'application iOS** correspondante.
2. **Application non installée, OS reconnu** — l'appareil est envoyé vers le **lien de boutique** correspondant (Google Play ou Apple App Store), si vous en avez renseigné un.
3. **Aucun des deux cas** — le scanneur est envoyé vers l'**URL web de repli**, ce qui explique pourquoi ce champ est obligatoire.

## Créer un QR code App Deep Link

<Steps>
  <Step title="Ouvrir Create QR Code et choisir Quick Code">
    Depuis la barre latérale, allez dans **QR Codes**, puis cliquez sur **Create QR Code** (ou naviguez vers `/qr/create`). Cliquez sur la carte **Quick Code**.
  </Step>

  <Step title="Choisir App Deep Link">
    Sur la grille de types **Quick Code**, cliquez sur **Configure** sous **App Deep Link**, dans la section **Dynamic** en haut (ce type n'a pas d'option Static). Cela ouvre le formulaire à `/qr/quick/appDeepLink`.
  </Step>

  <Step title="Ajouter les URI de votre application">
    Sous **App URIs**, saisissez au moins l'une des deux URI **Android app URI** ou **iOS app URI** — le schéma personnalisé que votre application enregistre pour s'ouvrir directement (par exemple `myapp://profile`).
  </Step>

  <Step title="Ajouter les liens de boutique (facultatif) et une URL de repli">
    Sous **Store links**, ajoutez éventuellement vos URL Google Play et/ou Apple App Store, affichées lorsque l'application n'est pas installée mais que l'OS de l'appareil est reconnu. Sous **Fallback URL**, saisissez une **Fallback web URL** — ce champ est obligatoire, car c'est la destination de dernier recours pour tous les autres cas.

    <Frame caption="Le formulaire Quick Code App Deep Link avec les URI d'application, les liens de boutique et une URL de repli renseignés">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/app-deep-link/app-deep-link-quick-code-form.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=fa5c24381e8f34cf1794154ecce881bc" alt="Formulaire Quick Code App Deep Link avec les URI d'application Android et iOS, des liens de boutique facultatifs, une URL de repli obligatoire, et l'URL courte générée automatiquement pour le QR code dynamique" width="1280" height="1277" data-path="images/v2/qr-codes/create/app-deep-link/app-deep-link-quick-code-form.png" />
    </Frame>
  </Step>

  <Step title="Publier">
    Cliquez sur **Publish**. Un panneau s'ouvre pour confirmer ou renommer le QR code, lui attribuer un dossier ou des étiquettes, et ajuster le design du QR code avant de confirmer.
  </Step>
</Steps>

## Le créer via l'API

Pour créer un QR code App Deep Link via l'API plutôt que via l'interface, utilisez l'ID de catégorie `23` (étiqueté **App Deep Link** dans le tableau **Category dropdown reference** de [Create QR Code](/v1/api-reference/endpoint/qr_manager/create), `allowed_qr_types: "dy"` — seul `"dy"` est valide pour `qr_type`). Contrairement à toutes les autres catégories de cette page, le contenu `info` ici est un **tableau brut** de blocs typés, et non un objet `{type, data}` :

```json theme={null}
[
  {
    "type": "intentUri",
    "data": [
      { "type": "android", "uri": "acmeapp://profile/42" },
      { "type": "ios", "uri": "acmeapp://profile/42" }
    ]
  },
  {
    "type": "appStore",
    "data": [
      { "type": "playStore", "url": "https://play.google.com/store/apps/details?id=com.acme.app" },
      { "type": "appleStore", "url": "https://apps.apple.com/app/id123456789" }
    ]
  },
  {
    "type": "fallback",
    "data": { "url": "https://acme.com/profile/42" }
  }
]
```

Chaque bloc est en principe facultatif, mais l'`url` du bloc `fallback` est en pratique obligatoire — publier sans repli échoue la validation exactement comme le formulaire du tableau de bord le bloque. N'incluez un bloc `intentUri` que si vous disposez d'au moins une URI d'application.

Voir [Create QR Code](/v1/api-reference/endpoint/qr_manager/create) pour le schéma complet de la requête.

## À voir aussi

* [App Store QR Code](/fr/qr-codes/create/app-store) — une alternative plus simple « envoyer vers la boutique » lorsque vous n'avez pas besoin de deep linking dans l'application.
* [Créer votre premier QR code](/fr/getting-started/first-qr-code) — un guide complet du flux Quick Code auquel appartient ce type.
* [Dossiers, étiquettes et opérations en masse](/fr/qr-codes/manage/folders-tags-bulk-operations) — organiser le QR code après l'avoir publié.