Создавайте динамические ссылки с помощью REST API

Вы можете создавать короткие динамические ссылки с помощью REST API Firebase Dynamic Links. Этот API принимает длинную динамическую ссылку или объект, содержащий параметры динамической ссылки, и возвращает URL-адрес, как в следующем примере:

https://example.page.link/WXYZ

Короткие динамические ссылки, созданные с помощью API и клиентского (Android / Apple) SDK, не отображаются в консоли Firebase. Такие динамические ссылки предназначены для обмена между пользователями. Для маркетинга случаев использования, продолжают создавать ссылки непосредственно через страницу Динамические ссылки консоли Firebase.

Прежде чем вы начнете

  1. Получите свой ключ API. Вам понадобится ключ API для аутентификации ваших запросов к API. Чтобы найти свой ключ API:
    1. Откройте страницу Настройки консоли Firebase. Если вам будет предложено выбрать проект, выберите свой проект Firebase в меню.
    2. Обратите внимание на значение поля Web API Key.
  2. В Firebase консоли откройте раздел Динамические ссылки.
  3. Если вы еще не приняли условия обслуживания и не установили домен для динамических ссылок, сделайте это при появлении соответствующего запроса.

    Если у вас уже есть домен динамических ссылок, примите его к сведению. Вам необходимо предоставить домен динамических ссылок, когда вы программно создаете динамические ссылки.

Вы можете использовать Firebase Dynamic Links API, чтобы сократить длинную динамическую ссылку. Для этого, создайте запрос HTTP POST на shortLinks конечной точки, указав длинный Dynamic Link в longDynamicLink параметра. Например:

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

См вручную построить URL , чтобы узнать , как создавать длинные динамические ссылки.

Вы также можете создать короткую динамическую ссылку, указав параметры динамической ссылки напрямую. Для этого, создайте запрос HTTP POST на shortLinks конечной точки, указав параметры Dynamic Link в dynamicLinkInfo параметра. Например:

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

Для полной спецификации dynamicLinkInfo объекта, увидеть ссылку API .

Установите длину короткой динамической ссылки

Вы также можете установить suffix параметр , чтобы указать , каким образом создается компонент пути короткого Dynamic Link.

По умолчанию, или если вы установите параметр в "UNGUESSABLE" , компонент пути будет 17-символьная строка а, например , как в следующем примере:

https://example.page.link/UVWXYZuvwxyz12345

Такие строки создаются путем кодирования base62 случайно сгенерированных 96-битных чисел. Используйте этот параметр, чтобы предотвратить поиск и сканирование URL-адресов динамических ссылок, которые потенциально могут раскрыть конфиденциальную информацию непреднамеренным получателям.

Если вы установите параметр "SHORT" , составляющая пути будет строкой , которая является лишь столько , сколько необходимо , чтобы быть уникальными, с минимальной длиной 4 -х символов.

https://example.page.link/WXYZ

Используйте этот метод, если конфиденциальная информация не будет раскрыта при угадывании короткого URL динамической ссылки.

В следующем примере показано , как вы можете установить 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"
   }
}

Как минимум, указанное значение глубинной ссылки должно начинаться со схем http: // или https: //. Он также должен соответствовать любому белому списку шаблонов URL, введенному в консоли. В противном случае API создания завершится с ошибкой с кодом HTTP 400.

Следующие шаги

Теперь, когда вы создали динамические ссылки, вам необходимо настроить приложение для получения динамических ссылок и отправки пользователей в нужное место в вашем приложении после того, как пользователь их откроет.

Для того, чтобы получить динамические ссылки в вашем приложении, обратитесь к документации для IOS , Android , C ++ , и единства .

Запросы ограничены 5 запросами на IP-адрес в секунду и 200 000 запросов в день. Если превышены, то ответ будет возвращать HTTP код ошибки 429. Для запроса для получения дополнительной квоты, заполните эту форму .