Webhook - Create Registration Partner
Crea la registrazione del tenant dell'utente.
POST https://api.partnercenter.microsoft.com/webhooks/v{version}/registration
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
version
|
path | True |
string |
Intestazione della richiesta
Media Types: "application/json", "text/json"
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| Authorization | True |
string |
Token di autenticazione di connessione |
| ms-correlationid |
string |
Identificatore univoco per la chiamata, utile nei log e nelle tracce di rete per la risoluzione degli errori. Il valore deve essere reimpostato per ogni chiamata. Tutte le operazioni devono includere questa intestazione. |
|
| ms-requestid |
string |
Identificatore univoco per la chiamata, usato per garantire l'idempotenza. Nel caso di un timeout, la chiamata di ripetizione dei tentativi deve includere lo stesso valore. Quando si riceve una risposta (esito positivo o negativo aziendale), il valore deve essere reimpostato per la chiamata successiva. |
Corpo della richiesta
Media Types: "application/json", "text/json"
| Nome | Tipo | Descrizione |
|---|---|---|
| lastModifiedTimestamp |
string (date-time) |
|
| properties |
object |
|
| signatureTokenToMsSignatureHeader |
boolean |
|
| subscriberId |
string |
|
| webhookEvents |
string[] |
|
| webhookUrl |
string |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
OK Media Types: "application/json", "text/json" |
|
| 400 Bad Request |
Non è presente un input mancante o non valido. Il corpo della risposta fornirà i dettagli dell'errore. Media Types: "application/json", "text/json" |
|
| 401 Unauthorized |
La richiesta non è stata autenticata. Il client deve prima eseguire l'autenticazione con il servizio API partner. Media Types: "application/json", "text/json" |
|
| 403 Forbidden |
La richiesta è stata autenticata ma è stata rifiutata perché il chiamante non dispone dei diritti per richiamarlo. Media Types: "application/json", "text/json" |
|
| 404 Not Found |
La risorsa non viene trovata o non è disponibile con i parametri di input specificati. Media Types: "application/json", "text/json" |
|
| 500 Internal Server Error |
Il servizio API partner o una delle relative dipendenze non è riuscito a soddisfare la richiesta. I chiamanti possono riprovare. Media Types: "application/json", "text/json" |
|
| Other Status Codes |
La registrazione esiste già, usare il metodo PUT per aggiornare una registrazione. Media Types: "application/json", "text/json" |
Sicurezza
Authorization
Token di autenticazione di connessione
Tipo:
apiKey
In:
header
Definizioni
WebhookRegistration
| Nome | Tipo | Descrizione |
|---|---|---|
| lastModifiedTimestamp |
string (date-time) |
|
| properties |
object |
|
| signatureTokenToMsSignatureHeader |
boolean |
|
| subscriberId |
string |
|
| webhookEvents |
string[] |
|
| webhookUrl |
string |