Cree enlaces dinámicos con la API REST

Puede crear vínculos dinámicos cortos con la API REST de vínculos dinámicos de Firebase. Esta API acepta un vínculo dinámico largo o un objeto que contiene parámetros de vínculo dinámico y devuelve una URL como la del siguiente ejemplo:

https://example.page.link/WXYZ

Los enlaces dinámicos cortos creados con la API y el SDK del cliente (Android/Apple) no aparecen en Firebase console. Dichos enlaces dinámicos están destinados a ser compartidos de usuario a usuario. Para casos de uso de marketing, continúe creando sus enlaces directamente a través de la página Dynamic Links de Firebase console.

Antes de que empieces

  1. Obtenga su clave API. Necesitará una clave API para autenticar sus solicitudes a la API. Para encontrar su clave API:
    1. Abra la página Configuración de Firebase console. Si se le solicita que elija un proyecto, seleccione su proyecto de Firebase en el menú.
    2. Tome nota del valor del campo Clave de API web .
  2. En Firebase console, abre la sección Enlaces dinámicos .
  3. Si aún no ha aceptado los términos de servicio y no ha configurado un dominio para sus Dynamic Links, hágalo cuando se le solicite.

    Si ya tienes un dominio de Dynamic Links, toma nota. Debe proporcionar un dominio de Dynamic Links cuando crea Dynamic Links mediante programación.

Puede utilizar la API de Firebase Dynamic Links para acortar un enlace dinámico largo. Para hacerlo, realice una solicitud HTTP POST al punto final shortLinks , especificando el enlace dinámico largo en el parámetro longDynamicLink . Por ejemplo:

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"
}

Consulte Construir manualmente una URL para aprender a crear enlaces dinámicos largos.

También puede crear un enlace dinámico corto especificando los parámetros del enlace dinámico directamente. Para hacerlo, realice una solicitud HTTP POST al punto final shortLinks , especificando los parámetros del vínculo dinámico en el parámetro dynamicLinkInfo . Por ejemplo:

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"
    }
  }
}

Para obtener una especificación completa del objeto dynamicLinkInfo , consulte la referencia de API .

Establecer la longitud de un enlace dinámico corto

También puede configurar el parámetro suffix para especificar cómo se genera el componente de ruta del enlace dinámico corto.

De forma predeterminada, o si configura el parámetro en "UNGUESSABLE" , el componente de ruta será una cadena de 17 caracteres, como en el siguiente ejemplo:

https://example.page.link/UVWXYZuvwxyz12345

Estas cadenas se crean mediante codificación base62 y números de 96 bits generados aleatoriamente. Utilice esta configuración para evitar que sus URL de Dynamic Links sean adivinadas y rastreadas, lo que potencialmente puede exponer información confidencial a destinatarios no deseados.

Si configura el parámetro en "SHORT" , el componente de la ruta será una cadena que será tan larga como sea necesaria para ser única, con una longitud mínima de 4 caracteres.

https://example.page.link/WXYZ

Utilice este método si la información confidencial no quedaría expuesta si se adivinara una URL corta de enlace dinámico.

El siguiente ejemplo muestra cómo puede configurar el parámetro suffix :

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"
   }
}

Como mínimo, el valor del vínculo profundo proporcionado debe comenzar con los esquemas http:// o https://. También debe coincidir con cualquier lista blanca de patrones de URL ingresada en la consola. De lo contrario, la API de creación fallará con el código de error HTTP 400.

Próximos pasos

Ahora que ha creado vínculos dinámicos, debe configurar su aplicación para recibir vínculos dinámicos y enviar a los usuarios al lugar correcto en su aplicación después de que un usuario los abra.

Para recibir vínculos dinámicos en su aplicación, consulte la documentación para iOS , Android , C++ y Unity .

Las solicitudes están limitadas a 5 solicitudes/dirección IP/segundo y 200.000 solicitudes/día. Si se excede, la respuesta devolverá el código de error HTTP 429. Para solicitar más cuota, complete este formulario .