Uzyskiwanie zgody klienta jako dostawcy panelu sterowania
Jako dostawca panelu sterowania (CPV) możesz użyć REST API do pozyskiwania i wycofywania zgody od klientów programu CSP, aby uzyskać dostęp do ich tenantów.
POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents
Notatka
Limit liczby żądań to 50 żądań na sekundę dla każdego identyfikatora aplikacji (ID aplikacji partnera CPV).
Uzyskiwanie zgody
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
| identyfikator_klienta | ścieżka | Prawda | struna | Identyfikator klienta wygenerowanego w Centrum partnerskim |
Nagłówek żądania
Typy multimediów: application/json
| Nazwa | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | struna | Token dostępu dla odbiorców https://api.partnercenter.microsoft.com |
| Akceptować | Prawda | struna | Akceptowalny typ zawartości; powszechnie akceptowany typ application/json |
| ms-correlationid | struna | Służy do wewnętrznego śledzenia żądań. Jeśli nie podano identyfikatora ms-correlationid, serwer generuje nowy dla każdego żądania | |
| ms-requestid | struna | Służy do zapewnienia idempotentności żądań. Jeśli parametr ms-requestid nie jest podany, serwer generuje nowy dla każdego żądania |
Treść żądania
Typy multimediów: application/json
| Nazwa | Typ | Opis |
|---|---|---|
| applicationId | struna | Identyfikator aplikacji partnera CPV |
| applicationGrants | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | Lista uprawnień aplikacji do uzyskania dostępu dla klientów w ich dzierżawcy |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK | Żądanie zakończyło się pomyślnie. Typy multimediów: application/json, application/xml, text/xml, text/json |
|
| 201 Utworzono | Zgoda aplikacji została utworzona. Typy multimediów: application/json, application/xml, text/xml, text/json |
|
| 400 Nieprawidłowe żądanie | Brak danych wejściowych lub nieprawidłowych. Treść odpowiedzi zawiera szczegóły błędu. Typy multimediów: application/json, application/xml, text/xml, text/json |
|
| 401 Brak autoryzacji | Żądanie nie zostało uwierzytelnione. Klient musi przekazać prawidłowy token dostępu dla prawidłowych odbiorców. Typy multimediów: application/json, application/xml, text/xml, text/json |
|
| 403 Zabronione | Żądanie zostało uwierzytelnione, ale odrzucono je, ponieważ dzwoniący nie ma uprawnień do jego wywołania. Typy multimediów: application/json, application/xml, text/xml, text/json |
|
| 404 Nie znaleziono | Zasób nie został znaleziony lub niedostępny z podanymi parametrami wejściowymi. Typy multimediów: application/json, application/xml, text/xml, text/json |
|
| Błąd wewnętrzny serwera 500 | Usługa interfejsu API partnera lub jedna z jego zależności nie spełniła żądania. Dzwoniący mogą ponowić żądanie. Typy multimediów: application/json, application/xml, text/xml, text/json |
Definicje
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
| Nazwa | Typ | Opis |
|---|---|---|
| IdentyfikatorAplikacjiPrzedsiębiorstwa | struna | Reprezentacja identyfikatora GUID zasobu uzyskującego dostęp |
| zakres | struna | Wartości zakresu rozdzielone przecinkami na potrzeby uzyskania dostępu |
Usuwanie zgody
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
Notatka
Limit liczby żądań to 50 żądań na sekundę dla każdego identyfikatora aplikacji (ID aplikacji partnera CPV).
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
| identyfikator_klienta | ścieżka | Prawda | struna | Identyfikator klienta wygenerowanego w Centrum partnerskim |
| Identyfikator_aplikacji | ścieżka | Prawda | struna | Identyfikator aplikacji CPV |
Nagłówek żądania
Typy multimediów: application/json
| Nazwa | Wymagane | Typ | Opis |
|---|---|---|---|
| Autoryzacja | Prawda | struna | Token dostępu dla odbiorcy https://api.partnercenter.microsoft.com |
| Akceptować | Prawda | struna | Akceptowalny typ zawartości, zazwyczaj typ application/json |
| ms-correlationid | struna | Jest używany do wewnętrznego śledzenia żądań. Jeśli nie podano ms-correlationid, serwer generuje nowy dla każdego żądania |
|
| ms-requestid | struna | Służy do zapewnienia idempotencji żądań. Jeśli parametr ms-requestid nie jest podany, serwer generuje nowy dla każdego żądania |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK | Żądanie zakończyło się pomyślnie. Typy multimediów: application/json, application/xml, text/xml, text/json |
|
| 201 Utworzono | Zgoda aplikacji zostanie usunięta. Typy multimediów: application/json, application/xml, text/xml, text/json |
|
| 400 Nieprawidłowe żądanie | Brak danych wejściowych lub nieprawidłowych. Treść odpowiedzi zawiera szczegóły błędu. Typy multimediów: application/json, application/xml, text/xml, text/json |
|
| 401 Brak autoryzacji | Żądanie nie zostało uwierzytelnione. Klient musi przekazać prawidłowy token dostępu dla prawidłowych odbiorców. Typy multimediów: application/json, application/xml, text/xml, text/json |
|
| 403 Zabronione | Żądanie zostało uwierzytelnione, ale odrzucono je, ponieważ dzwoniący nie ma uprawnień do jego wywołania. Typy multimediów: application/json, application/xml, text/xml, text/json |
|
| 404 Nie znaleziono | Zasób nie został znaleziony lub niedostępny z podanymi parametrami wejściowymi. Typy multimediów: application/json, application/xml, text/xml, text/json |
|
| Błąd wewnętrzny serwera 500 | Usługa interfejsu API partnera lub jedna z jego zależności nie spełniła żądania. Dzwoniący mogą ponowić żądanie. Typy multimediów: application/json, application/xml, text/xml, text/json |