Crie links dinâmicos com a API REST

Você pode criar links dinâmicos curtos com a API REST do Firebase Dynamic Links. Esta API aceita um link dinâmico longo ou um objeto contendo parâmetros de link dinâmico e retorna um URL como o exemplo a seguir:

https://example.page.link/WXYZ

Links dinâmicos curtos criados com a API e o SDK do cliente (Android/Apple) não aparecem no console do Firebase. Esses links dinâmicos destinam-se ao compartilhamento entre usuários. Para casos de uso de marketing, continue criando seus links diretamente na página Dynamic Links do Firebase console.

Antes de você começar

Obtenha sua chave de API. Você precisará de uma chave de API para autenticar suas solicitações na API. Para encontrar sua chave de API:
1. Abra a página Configurações do console do Firebase. Se você for solicitado a escolher um projeto, selecione seu projeto do Firebase no menu.
2. Anote o valor do campo Chave da API da Web .
No console do Firebase, abra a seção Dynamic Links .
Se você ainda não aceitou os termos de serviço e definiu um domínio para seus Dynamic Links, faça-o quando solicitado.
Se você já possui um domínio Dynamic Links, anote-o. Você precisa fornecer um domínio Dynamic Links ao criar Dynamic Links programaticamente.

Criando um link dinâmico curto

Crie um link curto a partir de um link longo

Você pode usar a API Firebase Dynamic Links para encurtar um link dinâmico longo. Para fazer isso, faça uma solicitação HTTP POST para o endpoint shortLinks , especificando o link dinâmico longo no parâmetro longDynamicLink . Por exemplo:

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 um URL para saber como criar links dinâmicos longos.

Crie um link curto a partir dos parâmetros

Você também pode criar um link dinâmico curto especificando diretamente os parâmetros do link dinâmico. Para fazer isso, faça uma solicitação HTTP POST para o endpoint shortLinks , especificando os parâmetros Dynamic Link no parâmetro dynamicLinkInfo . Por exemplo:

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 obter uma especificação completa do objeto dynamicLinkInfo , consulte a referência da API .

Defina a duração de um link dinâmico curto

Você também pode definir o parâmetro suffix para especificar como o componente de caminho do link dinâmico curto é gerado.

Por padrão, ou se você definir o parâmetro como "UNGUESSABLE" , o componente do caminho será uma sequência de 17 caracteres, como no exemplo a seguir:

https://example.page.link/UVWXYZuvwxyz12345

Essas strings são criadas pela codificação base62 de números de 96 bits gerados aleatoriamente. Use esta configuração para evitar que seus URLs de links dinâmicos sejam adivinhados e rastreados, o que pode expor informações confidenciais a destinatários não intencionais.

Se você definir o parâmetro como "SHORT" , o componente do caminho será uma string com o comprimento necessário para ser exclusivo, com comprimento mínimo de 4 caracteres.

https://example.page.link/WXYZ

Use este método se informações confidenciais não seriam expostas se um URL curto de link dinâmico fosse adivinhado.

O exemplo a seguir mostra como você pode definir o 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"
   }
}

Certifique-se de que o link direto seja válido

No mínimo, o valor do link direto fornecido deve começar com os esquemas http:// ou https://. Ele também deve corresponder a qualquer lista de permissões de padrões de URL inserida no console. Caso contrário, a API de criação falhará com o código de erro HTTP 400.

Próximos passos

Agora que você criou Dynamic Links, você precisa configurar seu aplicativo para receber Dynamic Links e enviar os usuários ao lugar certo em seu aplicativo depois que um usuário os abrir.

Para receber links dinâmicos em seu aplicativo, consulte a documentação para iOS , Android , C++ e Unity .

As solicitações são limitadas a 5 solicitações/endereço IP/segundo e 200.000 solicitações/dia. Se for excedido, a resposta retornará o código de erro HTTP 429. Para solicitar mais cota, preencha este formulário .