Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Crear enlaces dinámicos con la API REST

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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

https://example.page.link/WXYZ

Los vínculos dinámicos cortos creados con la API y el SDK del cliente (Android/Apple) no aparecen en la consola de Firebase. Dichos vínculos dinámicos están destinados a compartir 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 la consola de Firebase. 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, abra la sección Dynamic Links .
  3. Si aún no ha aceptado los términos de servicio y 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 usar la API de Firebase Dynamic Links para acortar un Dynamic Link largo. Para hacerlo, realice una solicitud HTTP POST al extremo de 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 Construcción manual de una URL para obtener información sobre cómo crear enlaces dinámicos largos.

También puede crear un Dynamic Link corto especificando los parámetros de Dynamic Link directamente. Para hacerlo, realice una solicitud HTTP POST al extremo de shortLinks , especificando los parámetros de 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 , consulte la referencia de la API .

Establecer la duración de un enlace dinámico corto

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

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

https://example.page.link/UVWXYZuvwxyz12345

Estas cadenas se crean codificando en base62 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 puede exponer información confidencial a destinatarios no deseados.

Si establece el parámetro en "SHORT" , el componente de la ruta será una cadena que tendrá la longitud 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 de enlace dinámico breve.

El siguiente ejemplo muestra cómo puede establecer el parámetro de 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 de enlace 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 Dynamic Links, debe configurar su aplicación para recibir Dynamic Links y enviar a los usuarios al lugar correcto en su aplicación después de que un usuario los abra.

Para recibir Dynamic Links 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 .