Поделиться через


Проверка данных Питни Боуз [НЕ РЕКОМЕНДУЕТСЯ]

Службы проверки данных Pitney Bowes помогают устранить ошибки в данных и улучшить взаимодействие с клиентами. Это упрощает взаимодействие, быстрее и без усилий путем обогащения сведений о клиенте, поддержания его up-to-date и поддержания его точности и согласованности. Дополнительные сведения см. на странице документации: https://aka.ms/kvz9oh

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Поддержка Питни Боуз
Адрес электронной почты software.support@pb.com
Метаданные соединителя
Publisher Компонент недоступен

Чтобы использовать эту интеграцию, необходимо иметь учетную запись в Центре разработчиков Pitney Bowes. Выполните приведенные ниже действия, чтобы получить ключ и секрет API.

Если при использовании соединителя возникает ошибка, вы можете найти код ошибки для получения дополнительных сведений. Обратите внимание, что код состояния HTTP в документации может немного отличаться от того, что вы видите в Power Automate или Power Apps, используйте поле "Код ошибки" для целей поиска.

Получение ключа и секрета API

  • Зарегистрируйтесь для учетной записи разработчика Pitney Bowes.
  • Войдите с помощью учетной записи разработчика и выберите ключи API в меню "Идентификация".

Вы увидите ключ API и секрет, указанные на странице "Ключ API".

Теперь вы готовы начать использовать эту интеграцию.

Сведения об нерекомендуемом состоянии

Соединитель проверки данных Pitney Bowes устарел по состоянию на август 2020 г. по запросу издателя соединителя.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя Тип Description Обязательно
Ключ API (дополнительные сведения см. здесь: https://aka.ms/kvz9oh) securestring Ключ API для Питни Боуз True
Секрет securestring Секрет клиента для Питни Боуз True

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Проверка адреса почты [не рекомендуется]

ValidateMailingAddress анализирует и сравнивает входные адреса с известными базами данных адресов по всему миру, чтобы вывести стандартизированные детали. Дополнительные сведения см. в нашей документации: https://aka.ms/wzsawb

Проверка адреса почты premium [DEPRECATED]

ValidateMailing AddressPremium расширяется на службе ValidateMailingAddressPro, добавив источники данных адресов класса Premium, чтобы получить наилучший результат проверки адресов. Дополнительные сведения см. в нашей документации: https://aka.ms/s9jl1k

Проверка адреса почты Pro [DEPRECATED]

ValidateMailingAddressPro строится на основе службы ValidateMailingAddress с помощью дополнительных баз данных адресов, чтобы обеспечить расширенные сведения. Дополнительные сведения см. в нашей документации: https://aka.ms/pbv0v9

Проверка адреса электронной почты [не рекомендуется]

Служба ValidateEmailAddress принимает адрес электронной почты и определяет, является ли он допустимым. Он может исправить распространенные опечатки для возврата допустимого адреса электронной почты. Он также определяет проблемные адреса электронной почты. Дополнительные сведения см. в нашей документации: https://aka.ms/Yqv7pc

Проверка адреса почты [не рекомендуется]

ValidateMailingAddress анализирует и сравнивает входные адреса с известными базами данных адресов по всему миру, чтобы вывести стандартизированные детали. Дополнительные сведения см. в нашей документации: https://aka.ms/wzsawb

Параметры

Имя Ключ Обязательно Тип Описание
Выходной регистр
OutputCasing string

Укажите регистр выходных данных.

Адресная строка 1
AddressLine1 string

Первая адресная строка.

Строка адреса 2
AddressLine2 string

Вторая строка адреса.

Название фирмы
FirmName string

Название компании или фирмы.

Город
City string

Имя города.

Государственная провинция
StateProvince string

Штат или провинция.

Страна
Country string

Код страны или имя.

Почтовый индекс
PostalCode string

Почтовый индекс адреса.

Возвращаемое значение

Имя Путь Тип Описание
array of object
Адресная строка 1
AddressLine1 string

Первая строка проверенного адреса.

Строка адреса 2
AddressLine2 string

Вторая строка проверенного адреса.

Название фирмы
FirmName string

Проверенное название фирмы или компании.

Город
City string

Проверенное имя города.

Почтовый индекс
PostalCode string

Проверенный ПОЧТОВЫй индекс™ или почтовый индекс.

Страна
Country string

Имя страны на английском языке.

Государственная провинция
StateProvince string

Проверенное название штата или провинции.

Блок-адрес
BlockAddress string

Отформатированный адрес, как он будет отображаться на физической части почты.

Дополнительные входные данные
AdditionalInputData string

Входные данные, не используемые процессом проверки адресов.

База почтовых индексов
PostalCodeBase string

5-значный ZIP-код™.

Добавление почтового кода
PostalCodeAddOn string

4-значная надстройка в ZIP-коде™.

Состояние
Status string

Сообщает об успешном выполнении или неудаче попытки соответствия.

Код состояния
StatusCode string

Причина сбоя, если есть один.

Описание состояния
StatusDescription string

Описание проблемы, если есть одна.

Проверка адреса почты premium [DEPRECATED]

ValidateMailing AddressPremium расширяется на службе ValidateMailingAddressPro, добавив источники данных адресов класса Premium, чтобы получить наилучший результат проверки адресов. Дополнительные сведения см. в нашей документации: https://aka.ms/s9jl1k

Параметры

Имя Ключ Обязательно Тип Описание
Блоки выходных адресов
OutputAddressBlocks string

Указывает, следует ли возвращать форматированную версию адреса, так как она будет напечатана на физической части почты.

Сохранение мультиматч
KeepMultimatch string

Указывает, следует ли возвращать несколько адресов для этих входных адресов с несколькими возможными совпадениями.

Формат выходной страны
OutputCountryFormat string

Указывает формат, используемый для имени страны, возвращаемого в поле выходных данных страны.

Тип выходных записей
OutputRecordType string

Указывает тип получаемой выходной записи.

Коды возвращаемых значений уровня выходных полей
OutputFieldLevelReturnCodes string

Указывает, следует ли включать индикаторы результатов на уровне поля.

Выходной скрипт
OutputScript string

Указывает алфавит или скрипт, в котором должны быть возвращены выходные данные.

Выходной регистр
OutputCasing string

Укажите регистр выходных данных.

Максимальные результаты
MaximumResults string

Число от 1 до 10, указывающее максимальное количество возвращаемых адресов.

Адресная строка 1
AddressLine1 string

Первая адресная строка.

Строка адреса 2
AddressLine2 string

Вторая строка адреса.

Адресная строка 3
AddressLine3 string

Третья строка адреса.

Адресная строка 4
AddressLine4 string

Четвертая строка адреса.

Строка адреса 5
AddressLine5 string

Пятая строка адреса.

Название фирмы
FirmName string

Название компании или фирмы.

Город
City string

Имя города.

Государственная провинция
StateProvince string

Штат или провинция.

Страна
Country string

Код страны или имя.

Почтовый индекс
PostalCode string

Почтовый индекс адреса.

Возвращаемое значение

Имя Путь Тип Описание
array of object
Состояние
Status string

Сообщает об успешном выполнении или неудаче попытки соответствия.

Код состояния
StatusCode string

Причина сбоя, если есть один.

Описание состояния
StatusDescription string

Описание проблемы, если есть одна.

Достоверность
Confidence string

Уровень достоверности, назначенный возвращаемой адресу.

Тип записи
RecordType string

Тип записи адреса.

Тип записи по умолчанию
RecordTypeDefault string

Код, указывающий соответствие по умолчанию.

Несколько совпадений
MultipleMatches string

Указывает, какой компонент адреса имел несколько совпадений.

Не удалось проверить
CouldNotValidate string

Упоминает компонент адреса, который не удалось проверить, если совпадение не найдено.

Уровень страны
CountryLevel string

Доступна категория сопоставления адресов.

Формат адреса
AddressFormat string

Тип возвращаемых данных адреса.

Адресная строка 1
AddressLine1 string

Первая строка проверенного адреса.

Строка адреса 2
AddressLine2 string

Вторая строка проверенного адреса.

Адресная строка 3
AddressLine3 string

Третья строка проверенного адреса.

Адресная строка 4
AddressLine4 string

Четвертая строка проверенного адреса.

Город
City string

Проверенное имя города.

Государственная провинция
StateProvince string

Проверенное название штата или провинции.

Почтовый индекс
PostalCode string

Проверенный ПОЧТОВЫй индекс™ или почтовый индекс.

База почтовых индексов
PostalCodeBase string

5-значный ZIP-код™.

Добавление почтового кода
PostalCodeAddOn string

4-значная надстройка в ZIP-коде™.

Страна
Country string

Страна в формате, определяемом вами.

Дополнительные входные данные
AdditionalInputData string

Входные данные, которые не удалось сопоставить с определенным компонентом адреса.

Название фирмы
FirmName string

Проверенное название фирмы или компании.

Номер дома
HouseNumber string

Номер дома.

Направление в начале
LeadingDirectional string

Направление в начале.

Имя улицы
StreetName string

Имя улицы.

Суффикс улицы
StreetSuffix string

Суффикс улицы.

Направление в тропу
TrailingDirectional string

Направление в направлении.

Метка квартиры
ApartmentLabel string

Конструктор квартир (например, STE или APT).

Номер квартиры
ApartmentNumber string

Номер квартиры.

Метка квартиры 2
ApartmentLabel2 string

Вторичный конструктор квартиры.

Номер квартиры 2
ApartmentNumber2 string

Вторичный номер квартиры.

RRHC
RRHC string

Индикатор контракта сельских маршрутов и шоссе.

PO Box
POBox string

Номер почтового ящика.

Частный почтовый ящик
PrivateMailbox string

Индикатор частного почтового ящика.

Тип частного почтового ящика
PrivateMailboxType string

Тип частного почтового ящика.

Входные данные номера дома
HouseNumberInput string

Номер дома.

Ввод в начале направления
LeadingDirectionalInput string

Направление в начале.

Входные данные имени улицы
StreetNameInput string

Имя улицы.

Входные данные Street Suffix
StreetSuffixInput string

Суффикс улицы.

Конечные направления ввода
TrailingDirectionalInput string

Направление в направлении.

Входные данные метки квартиры
ApartmentLabelInput string

Конструктор квартир (например, STE или APT).

Входные данные номера квартиры
ApartmentNumberInput string

Номер квартиры.

Входные данные RRHC
RRHCInput string

Индикатор контракта сельских маршрутов и шоссе.

Входные данные PO Box
POBoxInput string

Номер почтового ящика.

Входные данные частного почтового ящика
PrivateMailboxInput string

Индикатор частного почтового ящика.

Входные данные типа частного почтового ящика
PrivateMailboxTypeInput string

Тип частного почтового ящика.

Входные данные города
CityInput string

Проверенное имя города.

Вход в провинцию штата
StateProvinceInput string

Проверенное имя штата или провинции.

Входные данные почтового кода
PostalCodeInput string

Проверенный почтовый индекс.

Входные данные страны
CountryInput string

Страна. Формат определяется выбранным в OutputCountryFormat.

Входные данные имени фирмы
FirmNameInput string

Проверенное название фирмы или компании.

Результат номера дома
HouseNumberResult string

Индикатор результата на уровне поля для HouseNumber.

Ведущий результат направления
LeadingDirectionalResult string

Индикатор результатов на уровне поля для LeadingDirectional.

Результат улицы
StreetResult string

Индикатор результата на уровне поля для Street.

Результат имени улицы
StreetNameResult string

Индикатор результата на уровне поля для StreetName.

Тип псевдонима имени улицы
StreetNameAliasType string

Индикатор результата на уровне поля для псевдонима StreetName.

Результат суффикса street
StreetSuffixResult string

Индикатор результата на уровне поля для StreetSuffix.

Конечный результат направления
TrailingDirectionalResult string

Индикатор результатов на уровне поля для TrailingDirectional.

Результат метки квартиры
ApartmentLabelResult string

Индикатор результата на уровне поля для ApartmentLabel.

Результат номера квартиры
ApartmentNumberResult string

Индикатор результата на уровне поля для ApartmentNumber.

Результат метки квартиры 2
ApartmentLabel2Result string

Индикатор результата на уровне поля для ApartmentLabel2.

Результат номера квартиры 2
ApartmentNumber2Result string

Индикатор результата уровня поля для ApartmentNumber2.

Результат RRHC
RRHCResult string

Индикатор результатов на уровне поля для RRHC.

Тип RRHC
RRHCType string

Индикатор результата на уровне поля для типа RRHC.

Результат PO Box
POBoxResult string

Индикатор результата на уровне поля для POBox.

Результат города
CityResult string

Индикатор результатов на уровне поля для города.

Результат провинции штата
StateProvinceResult string

Индикатор результата на уровне поля для StateProvince.

Результат почтового кода
PostalCodeResult string

Индикатор результата на уровне поля для Почтового кода.

Результат города почтового кода
PostalCodeCityResult string

Индикатор результата на уровне поля для PostalCodeCity.

Результат записи адресов
AddressRecordResult string

Индикатор результата на уровне поля для AddressRecord.

Источник почтового кода
PostalCodeSource string

Индикатор результата на уровне поля для источника Почтового кода.

Почтовый индекс
PostalCodeType string

Указывает тип возвращаемого почтового кода.

Результат страны
CountryResult string

Проверенное название фирмы или компании.

Результат имени фирмы
FirmNameResult string

Указывает, проверено ли название фирмы.

Результат предпочтительного псевдонима имени улицы
StreetNamePreferredAliasResult string

Указывает результат обработки предпочтительного псевдонима.

Сокращенный результат псевдонима имени улицы
StreetNameAbbreviatedAliasResult string

Указывает результат обработки сокращенного псевдонима.

Строка адреса 5
AddressLine5 string

Пятая строка проверенного адреса.

Качество адресов
AddressQuality string

Код двух символов, указывающий общее качество результирующего адреса.

Доступность доставки
Deliverability string

Оценка достоверности того, что товар отправлен или отправлен в этот адрес успешно доставлен.

Тип адреса
AddressType string

Один код буквы, указывающий тип адреса.

Местность
Locality string

Район является деревней в сельских районах или может быть пригородом в городских районах.

Оценка изменений
ChangeScore string

Значение 0 и 100, которое отражает, сколько адрес изменился, чтобы сделать его допустимым.

Пригород
Suburb string

Проверенное название фирмы или компании.

Блок-адрес
BlockAddress string

Это отформатированный адрес, как он будет отображаться на физической части почты.

Широта
Latitude string

Семизначное число в градусах, вычисляемое до четырех десятичных разрядов.

Долгота
Longitude string

Семизначное число в градусах, вычисляемое до четырех десятичных разрядов.

Проверка адреса почты Pro [DEPRECATED]

ValidateMailingAddressPro строится на основе службы ValidateMailingAddress с помощью дополнительных баз данных адресов, чтобы обеспечить расширенные сведения. Дополнительные сведения см. в нашей документации: https://aka.ms/pbv0v9

Параметры

Имя Ключ Обязательно Тип Описание
Блоки выходных адресов
OutputAddressBlocks string

Указывает, следует ли возвращать форматированную версию адреса, так как она будет напечатана на физической части почты.

Сохранение мультиматч
KeepMultimatch string

Указывает, следует ли возвращать несколько адресов для этих входных адресов с несколькими возможными совпадениями.

Формат выходной страны
OutputCountryFormat string

Указывает формат, используемый для имени страны, возвращаемого в поле выходных данных страны.

Выходной скрипт
OutputScript string

Указывает алфавит или скрипт, в котором должны быть возвращены выходные данные.

Выходной регистр
OutputCasing string

Укажите регистр выходных данных.

Максимальные результаты
MaximumResults string

Число от 1 до 10, указывающее максимальное количество возвращаемых адресов.

Адресная строка 1
AddressLine1 string

Первая адресная строка.

Строка адреса 2
AddressLine2 string

Вторая строка адреса.

Название фирмы
FirmName string

Название компании или фирмы.

Город
City string

Имя города.

Государственная провинция
StateProvince string

Штат или провинция.

Страна
Country string

Код страны или имя.

Почтовый индекс
PostalCode string

Почтовый индекс адреса.

Возвращаемое значение

Имя Путь Тип Описание
array of object
Адресная строка 1
AddressLine1 string

Первая строка проверенного адреса.

Строка адреса 2
AddressLine2 string

Вторая строка проверенного адреса.

Название фирмы
FirmName string

Проверенное название фирмы или компании.

Оценка изменений
ChangeScore string

Значение 0 и 100, которое отражает, сколько адрес изменился, чтобы сделать его допустимым.

Местность
Locality string

Как правило, это деревня в сельских районах или это может быть пригород в городских районах.

Пригород
Suburb string

Имя пригорода.

Тип адреса
AddressType string

Один код буквы, указывающий тип адреса.

Доступность доставки
Deliverability string

Оценка достоверности того, что товар отправлен или отправлен в этот адрес успешно доставлен.

Качество адресов
AddressQuality string

Код двух символов, указывающий общее качество результирующего адреса.

Не удалось проверить
CouldNotValidate string

Упоминает компонент адреса, который не удалось проверить, если совпадение не найдено.

Город
City string

Проверенное имя города.

Почтовый индекс
PostalCode string

Проверенный ПОЧТОВЫй индекс™ или почтовый индекс.

Страна
Country string

Страна в формате, определяемом вами.

Государственная провинция
StateProvince string

Проверенное название штата или провинции.

Блок-адрес
BlockAddress string

Отформатированный адрес, как он будет отображаться на физической части почты.

Дополнительные входные данные
AdditionalInputData string

Входные данные, которые не удалось сопоставить с определенным компонентом адреса.

База почтовых индексов
PostalCodeBase string

5-значный ZIP-код™.

Добавление почтового кода
PostalCodeAddOn string

4-значная надстройка в ZIP-коде™.

Состояние
Status string

Сообщает об успешном выполнении или неудаче попытки соответствия.

Код состояния
StatusCode string

Причина сбоя, если есть один.

Описание состояния
StatusDescription string

Описание проблемы, если есть одна.

Проверка адреса электронной почты [не рекомендуется]

Служба ValidateEmailAddress принимает адрес электронной почты и определяет, является ли он допустимым. Он может исправить распространенные опечатки для возврата допустимого адреса электронной почты. Он также определяет проблемные адреса электронной почты. Дополнительные сведения см. в нашей документации: https://aka.ms/Yqv7pc

Параметры

Имя Ключ Обязательно Тип Описание
Поддельный
bogus string

Указывает, следует ли проверять, является ли адрес электронной почты вымышленным. Значение по умолчанию — «истина».

Жаловаться
complain string

Указывает, следует ли проверять, может ли владелец адреса электронной почты отправлять жалобы на спам. Значение по умолчанию — «истина».

Одноразовый
disposable string

Указывает, следует ли проверять, исходит ли адрес электронной почты с веб-сайта, предоставляющего временные адреса электронной почты. Значение по умолчанию — «истина».

Atc
atc string

Один код символов, который управляет поведением расширенного предложения. Значение по умолчанию является агрессивным.

Электронная почта
emailAddress string

Адрес электронной почты, который требуется проверить.

Эмпс
emps string

Указывает, следует ли проверять, отображается ли адрес электронной почты в списке "Не отправлять сообщения электронной почты" в ассоциации прямого маркетинга. Значение по умолчанию — «истина».

FCC Беспроводной
fccwireless string

Указывает, следует ли проверять, связан ли адрес электронной почты с доменом с ограничениями на коммерческую почту на FCC. Значение по умолчанию — «истина».

Language
language string

Указывает, следует ли проверять, содержит ли дескриптор электронной почты дескрипторные слова. Значение по умолчанию — «истина».

Role
role string

Указывает, имеет ли адрес электронной почты не персональный дескриптор, например info@, sales@ или webmaster@. Значение по умолчанию — «истина».

RTC
rtc string

Включает или отключает подтверждение в режиме реального времени. Значение по умолчанию — «истина».

Время ожидания RTC
rtc_timeout string

Указывает время ожидания для подтверждения в режиме реального времени. Значение по умолчанию — 1200.

Возвращаемое значение

Имя Путь Тип Описание
array of object
Комментарий
COMMENT string

Строка комментария, относящаяся к результату отправленного адреса электронной почты.

Код комментария
COMMENT_CODE string

Короткий код, который сопоставляется с каждым возвращаемым значением поля COMMENT.

Адрес электронной почты
EMAIL string

Адрес электронной почты, отправленный для проверки.

Ошибка
ERROR string

Поле зарезервировано только для специальных функций.

Ответ на ошибку
ERROR_RESPONSE string

Предварительно отформатированный ответ, предназначенный для предоставления пользователю.

Обнаружение
FINDING string

Один символьный код, указывающий на допустимость отправленного адреса электронной почты.

Комментарий предложения
SUGG_COMMENT string

Это поле содержит "предложение не SafeToDeliver", когда ValidateEmailAddress исправил адрес и исправленную версию адреса электронной почты не удалось выполнить одну или несколько проверок процесса SafeToDeliver.

Электронная почта предложения
SUGG_EMAIL string

Предлагаемое исправление для отправленного адреса электронной почты, если найдено. Предложение будет предоставлено только в том случае, если оно допустимо и SafeToDeliver.