Crea Dynamic Links con la API de REST

Puedes crear Dynamic Links cortos con la API de REST de Firebase Dynamic Links. Esta acepta un Dynamic Link largo o un objeto que contiene parámetros de un Dynamic Link y, luego, muestra una URL como el siguiente ejemplo:

https://example.page.link/WXYZ

Los Dynamic Links cortos creados con la API y el SDK cliente (Android/Apple) no aparecen en Firebase console. Están diseñados para el uso compartido entre usuarios. En casos de uso de marketing, sigue creando tus vínculos con la página de Dynamic Links en Firebase console.

Antes de comenzar

  1. Obtén tu clave de API. Necesitarás una clave de API para autenticar tus solicitudes a la API. Sigue estas instrucciones para encontrarla:
    1. Abre la página Configuración de Firebase console. Si se te pide que selecciones un proyecto, elige tu proyecto de Firebase desde el menú.
    2. Anota el valor del campo clave de API web.
  2. En Firebase console, abre la sección Dynamic Links.
  3. Si aún no aceptaste las Condiciones del Servicio ni configuraste un dominio para los Dynamic Links, deberás hacerlo cuando el sistema lo solicite.

    Si ya tienes un dominio de Dynamic Links, anótalo. Deberás proporcionar un dominio para crear Dynamic Links de manera programática.

Puedes usar la API de Firebase Dynamic Links para acortar un Dynamic Link largo. Para hacerlo, realiza una solicitud HTTP POST al extremo shortLinks y especifica el Dynamic Link 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"
}

Consulta Construye una URL manualmente para aprender a crear Dynamic Links largos.

También puedes especificar los parámetros del Dynamic Link directamente para crear un Dynamic Link corto. Para hacerlo, realiza una solicitud HTTP POST al extremo shortLinks y especifica los parámetros del Dynamic Link 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, consulta la referencia de la API.

Configura la longitud de un Dynamic Link corto

También puedes establecer el parámetro suffix para especificar cómo se genera el componente de la ruta de acceso del Dynamic Link corto.

Según la configuración predeterminada o si configuras el parámetro como "UNGUESSABLE", el componente de la ruta de acceso será una string de 17 caracteres, como se muestra en el siguiente ejemplo:

https://example.page.link/UVWXYZuvwxyz12345

Estas strings se crean a partir de números de 96 bits generados al azar con codificación de base62. Usa esta configuración para impedir que puedan adivinarse y rastrearse las URL de tus Dynamic Links, lo que podría exponer la información sensible ante destinatarios no deseados.

Si configuras el parámetro como "SHORT", el componente de la ruta de acceso será una string que tendrá solo la cantidad de caracteres necesaria para ser única, con una longitud mínima de 4 caracteres.

https://example.page.link/WXYZ

Usa este método si no hay riesgo de que se exponga información sensible si se adivina la URL de un Dynamic Link corto.

El siguiente ejemplo muestra cómo establecer 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 directo proporcionado debe empezar con los esquemas http:// o https://. También debe coincidir con alguna lista de entidades permitidas 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 creaste Dynamic Links, debes configurar tu app para recibir Dynamic Links y enviar a los usuarios al lugar correcto de tu app cuando los abran.

Para recibir Dynamic Links en tu app, consulta la documentación de iOS, Android, C++ y Unity.

Las solicitudes se limitan a 5 solicitudes por dirección IP por segundo, y 200,000 solicitudes por día. Si se supera este límite, la respuesta mostrará el código de error HTTP 429. Para solicitar una cuota superior, completa este formulario.