Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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 |