Udostępnij za pośrednictwem

Uzyskiwanie organizacji klienta

  • Artykuł

Dotyczy: Centrum partnerskie

Pobiera zasób organizacji klienta.

Wymagania wstępne

  • Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje poświadczenia aplikacji i użytkownika lub uwierzytelnianie tylko dla aplikacji.

  • Identyfikator klienta (customer-tenant-id). Jeśli nie znasz identyfikatora klienta, możesz go wyszukać w Centrum partnerskim. Wybierz obszar roboczy Klienci na stronie głównej Centrum partnerskiego. Wybierz klienta z listy Klient, a następnie wybierz pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Szczegóły konta klienta. Identyfikator Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).

Ważne

Role GDAP są wymagane do wywołania tego interfejsu API. Język DAP nie jest obsługiwany. Uwierzytelnianie partnerów jest nadal wymagane (AdminAgent/HelpDeskAgent/SalesAgent)

Role GDAP

Będziesz potrzebować co najmniej jednej z następujących ról GDAP:

  • Globalny administrator usługi
  • Składnik zapisywania katalogów
  • Czytelnik globalny

Żądanie REST

Składnia żądania

Metoda Identyfikator URI żądania
GET {baseURL}/v1/customers/{customer-tenant-id}/organization HTTP/1.1

Parametr identyfikatora URI

Użyj następującego parametru zapytania dla określonego klienta.

Imię i nazwisko/nazwa Type Wymagana Opis
identyfikator dzierżawy klienta Identyfikator guid Y Wartość to identyfikator GUID sformatowany jako customer-tenant-id , który umożliwia odsprzedawcy filtrowanie wyników dla danego klienta należącego do odsprzedawcy.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Brak.

Przykład żądania

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/organization HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: a176c585-b5de-4d65-824c-67a6deb45cd9
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

Odpowiedź REST

Jeśli ta metoda powiedzie się, ta metoda zwraca zasób Klienta w treści odpowiedzi.

Kody powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów.

Przykład odpowiedzi

HTTP/1.1 200 OK
Content-Length: 1530
Content-Type: application/json; charset=utf-8
MS-CorrelationId: a176c585-b5de-4d65-824c-67a6deb45cd9
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

[
  {
    "street": "1 Microsoft Way",
    "countryLetterCode": "US",
    "postalCode": "98052-8300",
    "city": "Redmond",
    "state": "WA",
    "displayName": "Contoso",
    "technicalNotificationMails": [
      "test@contoso.com"
    ]
  }
]

Następne kroki