Obter regras pelo mercado de formatação de endereço

Artigo
09/16/2024

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o Microsoft Cloud for US Government

Obtenha o formato de endereço esperado com base no código iso para o mercado.

Pré-requisitos

Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.

Solicitação REST

Sintaxe da solicitação

Método	URI da solicitação
GET	{baseURL}/v1/countryvalidationrules/{isocode-id} HTTP/1.1

Parâmetro do URI

Nome	Type	Obrigatório	Descrição
isocode-id	cadeia de caracteres	Y	O código do país ISO dois caracteres.

Cabeçalhos de solicitação

Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Corpo da solicitação

Nenhum.

Exemplo de solicitação

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: aaaa0000-bb11-2222-33cc-444444dddddd

Resposta REST

Se tiver êxito, esse método retornará um objeto CountryInformation no corpo da resposta.

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira Códigos de Erro.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 1856
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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" 
  } 
}

Compartilhar via