Стандартный процесс работы API

Из этой статьи вы узнаете о типичных этапах взаимодействия с API, например добавлении класса, сохранении или обновлении объекта. Реализацией всех операций между браузером, вашим сервером и Google Pay API for Passes вы занимаетесь самостоятельно. Процессы работы с разными картами и билетами практически одинаковы. В качестве примера на диаграмме ниже представлен процесс взаимодействия с объектом LoyaltyObject.

Стандартный процесс работы API с кнопками JavaScript и ссылками на веб-токен JSON

Этот процесс изображен на диаграмме выше. Также вы можете ознакомиться с его описанием:

  1. Продавец создает ресурс LoyaltyClass.
    1. Сервер определяет переменные LoyaltyClass.
    2. Затем он отправляет запрос POST на добавление ресурса LoyaltyClass на сервер Google Pay API.
  2. По запросу сервера сервис создает веб-токен JSON (JWT) для объекта LoyaltyObject в определенном классе LoyaltyClass. Этот объект представляет собой карту постоянного клиента конкретного пользователя.
    1. Ваш сервер использует веб-токен JSON для добавления кнопки Сохранить в Google Pay (S2GP).
      • На сайтах размещайте кнопку JavaScript.
      • Для электронных писем, SMS и оригинальных приложений используйте ссылку JWT с кнопкой "Сохранить в Google Pay".
  3. Пользователь нажимает кнопку Сохранить в Google Pay на сайте, в электронном письме, оригинальном приложении или SMS от продавца карты постоянного клиента.
    1. Пользователь попадает на целевую страницу с предложением сохранить объект LoyaltyClass. Объект для сохранения отображается на целевой странице согласно настройке веб-токена JSON. Если пользователь нажал кнопку в оригинальном приложении, ему будет предложено сохранить объект в Google Pay.
    2. Затем он нажимает кнопку Сохранить в Google Pay на ресурсе продавца, чтобы добавить объект LoyaltyObject в приложение.
    3. Объект LoyaltyObject перемещается в Google Pay. LoyaltyObject получает название "Карта постоянного клиента".
  4. Продавец обновляет информацию о карте.
    1. Он использует параметр Object.id, чтобы подать запрос GET к объекту LoyaltyObject.
    2. Затем продавец обновляет объект LoyaltyObject.
    3. Чтобы добавить обновленный объект LoyaltyObject на сервер Google Pay API for Passes, продавец создает запрос PUT или PATCH.
    4. Объект LoyaltyObject перемещается в приложение Google Pay.

Сокращенный вариант ссылки на веб-токен JSON

В браузерах данные усекаются, поэтому JSON-токены в ссылках не должны превышать 1800 символов. Если соблюдать лимит не получается, советуем сначала добавить класс и объект, тогда в токене будет только поле object id.

На диаграмме ниже показан процесс работы с API, который позволяет добавить кнопку "Сохранить в Google Pay" в электронное письмо или SMS.