Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Créer des liens dynamiques avec l'API REST

Vous pouvez créer des liens dynamiques courts avec l'API REST Firebase Dynamic Links. Cette API accepte soit un lien dynamique long, soit un objet contenant des paramètres de lien dynamique, et renvoie une URL comme dans l'exemple suivant :

https://example.page.link/WXYZ

Les liens dynamiques courts créés avec l'API et le SDK client (Android/iOS) n'apparaissent pas dans la console Firebase. Ces liens dynamiques sont destinés au partage d'utilisateur à utilisateur. Pour la commercialisation de cas d'utilisation, continuer à créer vos liens directement à travers la page Liens de dynamique de la console Firebase.

Avant que tu commences

  1. Obtenez votre clé API. Vous aurez besoin d'une clé API pour authentifier vos requêtes auprès de l'API. Pour trouver votre clé API :
    1. Ouvrez la page Paramètres de la console Firebase. Si vous êtes invité à choisir un projet, sélectionnez votre projet Firebase dans le menu.
    2. Prenez note de la valeur de l'API Web champ Clé.
  2. Dans la console Firebase, ouvrez la section des liens dynamiques.
  3. Si vous n'avez pas encore accepté les conditions d'utilisation et défini un domaine pour vos liens dynamiques, faites-le lorsque vous y êtes invité.

    Si vous avez déjà un domaine Dynamic Links, prenez-en note. Vous devez fournir un domaine de liens dynamiques lorsque vous créez des liens dynamiques par programmation.

Vous pouvez utiliser l'API Firebase Dynamic Links pour raccourcir un long lien dynamique. Pour ce faire, faire une requête HTTP POST au shortLinks point final, en spécifiant long Dynamic Link dans le longDynamicLink paramètre. Par exemple:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json

{
   "longDynamicLink": "https://example.page.link/?link=https://www.example.com/&apn=com.example.android&ibi=com.example.ios"
}

Voir manuellement construire une URL pour apprendre comment créer des liens dynamiques à long.

Vous pouvez également créer un lien dynamique court en spécifiant directement les paramètres du lien dynamique. Pour ce faire, faire une requête HTTP POST au shortLinks point final, en spécifiant les paramètres Dynamic Link dans le dynamicLinkInfo paramètre. Par exemple:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json

{
  "dynamicLinkInfo": {
    "domainUriPrefix": "https://example.page.link",
    "link": "https://www.example.com/",
    "androidInfo": {
      "androidPackageName": "com.example.android"
    },
    "iosInfo": {
      "iosBundleId": "com.example.ios"
    }
  }
}

Pour une spécification complète du dynamicLinkInfo objet, consultez la référence API .

Définir la longueur d'un lien dynamique court

Vous pouvez également définir le suffix paramètre pour spécifier comment est généré le composant de chemin de court Dynamic Link.

Par défaut, ou si vous définissez le paramètre "UNGUESSABLE" , le composant de chemin sera une chaîne de 17 caractères, comme dans l'exemple suivant:

https://example.page.link/UVWXYZuvwxyz12345

De telles chaînes sont créées en encodant en base62 des nombres de 96 bits générés aléatoirement. Utilisez ce paramètre pour empêcher que vos URL de liens dynamiques ne soient devinées et analysées, ce qui peut potentiellement exposer des informations sensibles à des destinataires indésirables.

Si vous réglez le paramètre "SHORT" , le composant de chemin sera une chaîne qui est seulement aussi longtemps que nécessaire pour être unique, avec une longueur minimale de 4 caractères.

https://example.page.link/WXYZ

Utilisez cette méthode si des informations sensibles ne seraient pas exposées si une URL de lien dynamique courte était devinée.

L'exemple suivant montre comment vous pouvez définir le suffix paramètre:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json

{
   "longDynamicLink": "https://example.page.link/?link=http://www.example.com/&apn=com.example.android&ibi=com.example.ios",
   "suffix": {
     "option": "UNGUESSABLE"
   }
}

Au minimum, la valeur de lien profond fournie doit commencer par les schémas http:// ou https://. Il doit également correspondre à toute liste blanche de modèles d'URL saisie dans la console. Sinon, l'API de création échouera avec le code d'erreur HTTP 400.

Prochaines étapes

Maintenant que vous avez créé des liens dynamiques, vous devez configurer votre application pour recevoir des liens dynamiques et envoyer les utilisateurs au bon endroit dans votre application après qu'un utilisateur les ouvre.

Pour recevoir des liens dynamiques dans votre application, consultez la documentation pour iOS , Android , C ++ et l' unité .

Les demandes sont limitées à 5 demandes/adresse IP/seconde et 200 000 demandes/jour. En cas de dépassement, la réponse renvoie le code d'erreur HTTP 429. à la demande de plus de quotas, remplissez ce formulaire .