Een klant via ID ophalen

Artikel
03/08/2025

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

Hiermee haalt u een klantbron op die overeenkomt met een klant-ID.

Vereisten

Referenties zoals beschreven in Partner Center authenticatie. Dit scenario biedt ondersteuning voor app+gebruikersreferenties of alleen-app-verificatie.
Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in partnercentrum. Selecteer de werkruimte Klanten op de startpagina van Partnercentrum. Selecteer de klant uit de Klant lijst, selecteer vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountdetails. De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).

Belangrijk

De API-oproep 'Get Customer ID' zal de volgende kenmerken niet bevatten in de respons als de partner geen DAP-toegang heeft op de klanttenant. Anders worden alle kenmerken geretourneerd die worden vermeld in het antwoordvoorbeeld.

Bedrijfsprofieladres
E-mail bedrijf profiel
AangepastDomein

GDAP-rollen

Je hebt ten minste een van de volgende GDAP-rollen nodig om Een klantorganisatie op te halen voor CompanyProfileAddress, CompanyProfileEmail en om het aangepaste klantdomein op te halen voor CustomDomain.

Mapschrijver
Wereldwijde lezer
Domeinbeheerder

C#

Als u een klant op id wilt ophalen, gebruikt u de verzameling IAggregatePartner.Customers, roept u de Methode ById() aan en roept u vervolgens de Methoden Get() of GetAsync() aan.

// IAggregatePartner partnerOperations;
// string customerIdToRetrieve;

Customer customerInfo = partnerOperations.Customers.ById(customerIdToRetrieve).Get();

Voorbeeld: consoletest-app. Project: PartnerSDK.FeatureSamples Class: CustomerInformation.cs

Java

De Partner Center Java SDK kan worden gebruikt voor het beheren van Partnercentrum-resources. Het is een opensource-project dat wordt onderhouden door de partnercommunity en niet officieel wordt ondersteund door Microsoft. U kunt hulp krijgen van de community of een probleem openen op GitHub als u een probleem ondervindt.

Als u een klant op id wilt ophalen, gebruikt u de functie IAggregatePartner.getCustomers , roept u de functie byId() aan en roept u de functie get() aan.

// IAggregatePartner partnerOperations;
// String customerIdToRetrieve;

Customer customerInfo = partnerOperations.getCustomers().byId(customerIdToRetrieve).get();

Powershell

Het Partner Center PowerShell-module kan worden gebruikt om Partner Center-resources te beheren. Het is een opensource-project dat wordt onderhouden door de partnercommunity en niet officieel wordt ondersteund door Microsoft. U kunt hulp krijgen van de community of een probleem openen op GitHub als u een probleem ondervindt.

Als u een klant op basis van id wilt ophalen, voert u de opdracht Get-PartnerCustomer uit en geeft u de parameter CustomerId op.

Get-PartnerCustomer -CustomerId '2ca7de6c-c05c-46b5-b689-32e53573a97a'

REST-aanvraag

Aanvraagsyntaxis

Wijze	Aanvraag-URI
GET	{baseURL}/v1/customers/{customer-tenant-id} HTTP/1.1

URI-parameter

Gebruik de volgende queryparameter voor een specifieke klant.

Name	Soort	Vereist	Beschrijving
klanttenant-id	guid	Y	De waarde is een door een GUID opgemaakte klant-tenant-id waarmee de reseller de resultaten kan filteren op een bepaalde klant die deel uitmaakt van de reseller.

Aanvraag-headers

Voor meer informatie, zie Partnercentrum REST-headers.

Aanvraaglichaam

Geen.

Aanvraagvoorbeeld

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

REST-antwoord

Als dit lukt, retourneert deze methode een klantresource in de hoofdtekst van het antwoord.

Geslaagde antwoorden en foutcodes

Elke reactie wordt geleverd met een HTTP-statuscode die succes of falen aangeeft, plus aanvullende debuginformatie. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor de volledige lijst.

Responsvoorbeeld

HTTP/1.1 200 OK
Content-Length: 1530
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

{
  "id": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "commerceId": "99e6a635-48e7-424d-9059-c9db944e3c54",
  "companyProfile": {
    "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "domain": "abcdefgh1234.onmicrosoft.com",
    "companyName": "1kl as kjk",
    "address": {
      "country": "US",
      "region": "wa",
      "city": "redmond",
      "addressLine1": "1 ms way",
      "postalCode": "98052",
      "phoneNumber": "1234567890"
    },
    "email": "a@a.com",
    "links": {
      "self": {
        "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/profiles/company",
        "method": "GET",
        "headers": []
      }
    },
    "attributes": {
      "objectType": "CustomerCompanyProfile"
    }
  },
  "billingProfile": {
    "id": "eeada110-69d6-4cc9-b093-75feb7ca9d3f",
    "firstName": "d0d89d776d03471c819bf772191ed728",
    "lastName": "kjkAJJAAAAAAAAAAAAAAAAAAAA",
    "email": "a@a.com",
    "culture": "en-US",
    "language": "en",
    "companyName": "1kl as kjkAAAAAAAAAAAAAAAJJJJJJJJJJJAAAAAJJJJJJJJJJJAAJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJAJJJJJAJJAAAAJAJJAAAAAAAAAAAAAAAAAAAA",
    "defaultAddress": {
      "country": "US",
      "city": "redmond",
      "state": "WA",
      "addressLine1": "1 ms way",
      "postalCode": "98052",
      "firstName": "1kl as",
      "lastName": "kjk",
      "phoneNumber": "1234567890"
    },
    "links": {
      "self": {
        "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/profiles/billing",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "etag": "-4242348048554929329",
      "objectType": "CustomerBillingProfile"
    }
  },
  "relationshipToPartner": "reseller",
  "allowDelegatedAccess": true,
  "customDomains": [
    "abcdefgh1234.onmicrosoft.com"
  ],
  tags": [
    "TestCustomer",
    "USCustomer"
  ],
  "links": {
    "self": {
      "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee",
      "method": "GET",
      "headers": []
    }
  },
  "attributes": {
    "objectType": "Customer"
  }
}

Delen via