• Для каждого экземпляра Advanced Integrated Visibility требуется отдельный клиентский номер отправителя.
• Создаваемый клиентом целевой URL-адрес или конечная точка должны:
  
  • использовать протокол HTTPS;
    
  • Ответ на запросы POST и синтаксический анализ полезной нагрузки JSON.
  • Не более 200 символов
  • URL-адрес будет заблокирован, если он содержит:
    • пространство IP-адресов RFC1918;
    • fedex.com или любой поддомен этого сайта.
    • IP-адреса (включая localhost, 127.0.0.1).

• Безопасность Advanced Integrated Visibility: поддерживаются только соединения по протоколу HTTPS с технологией TLS (SSL) 1.2 или более поздней версии, настроенные с использованием сертификата, выданного правомочным удостоверяющим центром. Чтобы получать регулярно обновляемые сведения с серверов FedEx, необходимо внести в белый список IP-адреса в следующих случаях:
  

  Рабочая версия
  Клиенты могут внести в белый список адрес nat.fxconnect.eastus2.heap-prod.fedex.io
  Использование бесклассовой междоменной маршрутизации (CIDR): 20.65.16.22/31

• Сообщения могут поступать не в хронологическом порядке, поэтому следует обращать внимание на метку времени каждого события.
• Удаление учетных записей в FedEx Developer Portal
  • Пользователи и клиенты не могут перечисленные ниже счета.
    1. если учетная запись связана как минимум с одним проектом Advanced Integrated Visibility;
       
    2. Доступные для какого-либо проекта или связанные с ним.
    3. если это единственная учетная запись, связанная с проектом/экземпляром Advanced Integrated Visibility.
       
       Примечание. Следует сначала удалить учетную запись из проекта или экземпляра Advanced Integrated Visibility, а затем — из организации.
  • Пользователи и клиенты могут удалять счета при соблюдении следующих условий:
    1. счета принадлежат к их организации;
    2. у пользователя, удаляющего счета организации, есть права администратора.

Общие ограничения

• Дополнительные возможности действуют для всех отправлений клиента, которые связаны с 9-значными клиентскими номерами компаний, принадлежащих бренду FedEx: FedEx Express®, FedEx Ground® и FedEx Ground® Economy (ранее FedEx SmartPost®), независимо от пунктов отправления и назначения (входящих, исходящих, международных, внутренних и т. д.).
• Webhook Advanced Integrated Visibility поддерживает только 9-значные клиентские номера предприятий и пакетов. Клиентские номера предприятий позволяют создавать отправления, связанные со всеми компаниями, принадлежащими бренду FedEx, включая FedEx Express и FedEx Ground.


Примечание. 9-значные номера LTL Freight не поддерживаются. Чтобы добавить номер LTL Freight, необходимо договориться со службой поддержки клиента, чтобы перевести его в категорию счетов предприятия.
• Клиенты самостоятельно управляют порядком получения уведомлений о событиях отслеживания.
• Уведомления отправляются автоматически по электронной почте при каждом изменении статуса события в webhook Advanced Integrated Visibility (сохранение, сбой, создание, обновление, отмена или удаление).
• Перевод.
  • Полезные данные отслеживания могут отображаться на 41 языке.(скоро)
    Нажмите здесь, чтобы просмотреть список поддерживаемых языков.
  • Сейчас полезные данные отслеживания отображаются на английском языке (США).
  • Для отображения уведомлений по электронной почте поддерживаются только языки регионального стандарта США (en-US, es-US).

Роли на портале FedEx Developer Portal

В зависимости от настроек роли, пользователи портала могут выполнять определенные функции.
Подробные сведения о FedEx Developer Portal см. в Руководстве по администрированию организации.

Что такое MAC и HMAC и как они используются при проверке?

Код проверки подлинности сообщений позволяет с помощью секретного ключа проверить целостность информации, которая передается или хранится на ненадежном носителе. Обычно коды MAC используются двумя сторонами, которые пользуются общим секретным ключом, для проверки информации, пересылаемой между ними.

HMAC — это механизм MAC, который использует криптографические хеш-функции. HMAC допускает использование любых криптографических хеш-функций (например, SHA256) в сочетании с общим секретным ключом. Определение HMAC содержится в документе RFC 2104. Webhook FedEx Advanced Integrated Visibility использует HMAC SHA256.

SHA256 (маркер безопасности + полезная нагрузка) = подпись FDX в кодировке Base64 является частью заголовка полезной нагрузки

Расчет задержки

Время создания события показывает, когда событие фактически произошло в сети.
До тех пор, пока событие не будет зарегистрировано в системе (что указывается меткой времени создания сообщения), ни webhook, ни какие-либо другие системы не смогут его обработать или доставить.

Рекомендация

Для измерения задержки клиентам следует использовать метку времени создания сообщения, которая лучше всего отражает момент, когда событие стало доступно цифровым системам. Эта метка наиболее точно соответствует времени цифровых обновлений FedEx и обычно быстрее или совпадает с обновлениями, отображаемыми на сайте fedex.com.

Правила проверки 

• Имя webhook Advanced Integrated Visibility должно быть уникальным.
• Целевой URL-адрес webhook Advanced Integrated Visibility должен соответствовать стандартным правилам синтаксиса.
• Для создания webhook Advanced Integrated Visibility необходимо заполнить все обязательные поля.
• При создании webhook Advanced Integrated Visibility необходимо выбрать хотя бы один доступный клиентский номер отправителя FedEx.
• Успешная проверка:
  • Клиент получит сообщение об успешном создании экземпляра webhook Advanced Integrated Visibility.

    Пример подтверждения. <<Название экземпляра webhook Advanced Integrated Visibility>> успешно создан. Для вступления изменений в силу может потребоваться до 10 минут.

• Ошибка проверки:
  • Если FedEx получает в ответе код состояния HTTP, отличный от 200 (ОК) или 202 (Accepted), считается, что целевой URL-адрес webhook Advanced Integrated Visibility не прошел проверку.