Получение правил форматирования адреса в зависимости от рынка

Статья
09/16/2024

Область применения: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud for US Government

Получение ожидаемого формата адреса на основе ISO-кода для рынка.

Предварительные условия

Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает проверку подлинности с использованием учетных данных автономного приложения и приложения и пользователя.

Запрос REST

Синтаксис запроса

Метод	Универсальный код ресурса (URI) запроса
GET	{baseURL}/v1/countryvalidationrules/{isocode-id} HTTP/1.1

Параметр универсального кода ресурса (URI)

Имя	Тип	Обязательно	Описание
isocode-id	строка	Да	Двухсимвольный код ISO страны.

Заголовки запроса

Дополнительные сведения см. в статье о заголовках REST Центра партнеров.

Тело запроса

Нет.

Пример запроса

GET https://api.partnercenter.microsoft.com/v1/countryvalidationrules/{isocode-id} HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 124b0e41-a093-4fec-b871-3eeb45fd734b
MS-CorrelationId: 5cfd634d-b936-47af-87f0-0f0217425dcc

Ответ REST

В случае успешного выполнения этот метод возвращает объект CountryInformation в тексте ответа.

Коды успешного выполнения и ошибок в ответе

Каждый ответ сопровождается кодом состояния HTTP, обозначающим успешное или неудачное выполнение, и дополнительными сведениями для отладки. Используйте средство трассировки сети, чтобы просматривать этот код, тип ошибки и дополнительные параметры. См. полный список кодов ошибок.

Пример ответа

HTTP/1.1 200 OK
Content-Length: 1856
Content-Type: application/json
MS-CorrelationId: 5cfd634d-b936-47af-87f0-0f0217425dcc
MS-RequestId: 124b0e41-a093-4fec-b871-3eeb45fd734b
Date: Wed, 25 Nov 2015 06:36:47 GMT

{ 
  "iso2Code": "US", 
  "defaultCulture": "en-US", 
  "isStateRequired": true, 
  "supportedStatesList": [ 
    "AK", "AL", "AR", "AZ", "CA", "CO", "CT", "DC", "DE", "FL", "GA", "HI", "IA", "ID", "IL", "IN", "KS", 
    "KY", "LA", "MA", "MD", "ME", "MI", "MN", "MO", "MS", "MT", "NC", "ND", "NE", "NH", "NJ", "NM", "NV", 
    "NY", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VA", "VT", "WA", "WI", "WV", "WY" 
  ], 
  "supportedLanguagesList": [ 
    "en", 
    "es" 
  ], 
  "supportedCulturesList": [ 
    "en-US", 
    "es-US" 
  ], 
  "isPostalCodeRequired": true, 
  "postalCodeRegex": "^\\d{5}(-\\d{4})?$", 
  "isCityRequired": true, 
  "isVatIdSupported": false, 
  "phoneNumberRegex": "^(1[ \\-/\\.]?)?(\\((\\d{3})\\)|(\\d{3}))[ \\-/\\.]?(\\d{3})[ \\-/\\.]?(\\d{4})$", 
  "isTaxIdSupported": true, 
  "isTaxIdOptional": true, 
  "countryCallingCodesList": [ 
    "1" 
  ], 
  "attributes": { 
    "objectType": "CountryValidationRules" 
  } 
}

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