Abrufen von Adressformatierungsregeln nach Markt

Artikel
09/16/2024

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

Rufen Sie das erwartete Adressformat basierend auf dem ISO-Code für den Markt ab.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
GET	{baseURL}/v1/countryvalidationrules/{isocode-id} HTTP/1.1

URI-Parameter

Name	Typ	Erforderlich	BESCHREIBUNG
ISO-Code-ID	string	J	Der aus zwei Zeichen bestehende ISO-Ländercode.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine.

Anforderungsbeispiel

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

REST-Antwort

Bei erfolgreicher Ausführung gibt diese Methode ein CountryInformation-Objekt im Antworttext zurück.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.

Antwortbeispiel

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" 
  } 
}

Freigeben über