POST | /sync/webhooks/subscriptions/{Id}/update |
---|
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | string | Yes | The unique identifier of the subscriber. |
Name | form | string | No | The name of the subscription. |
Event | form | string | No | The name of the subscribed event. |
Url | form | string | No | The callback URL to be called when an "event" of a certain type is going to be raised. |
ContentType | form | string | No | The MIME type of content pushed to the recipient service e.g. application/json |
CurrentSecret | form | string | Yes | The current secret that is used to sign and authenticate messages from webhook endpoints. |
NewSecret | form | string | No | A random Base64-encoded secret key (8 or more characters) to sign and authenticate messages from webhook endpoints. .When receiving a webhook event in your subscribers service, calculate the HMAC signature of the request body using this secret. Compare the calculated signature with the signature included in the "X-Hub-Signature" header of the web hook event. If the signatures do not match, then disregard it, and don't process the request any further. |
IsActive | form | bool? | No | Indicates whether the subscription is enabled or disabled. |
PublicKeyXml | form | string | Yes | The XML-encoded RSA public key to encrypt the new secret of the webhook subscription. Note: Only the owner of the key pair (public and private encryption keys) can decrypt the encrypted secret with the private key! Encryption algorithm: RSA with OAEP-SHA256 padding. |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Subscription | form | WebhookSubscription | No | The encapsulated webhook subscription of the response. The secret of the webhook subscription is encrypted and can only be decrypted by the owner of the private key. |
History | form | List<SubscriptionDeliveryResult> | No | The history of the subscription event. |
ResponseStatus | form | ResponseStatus | No | The status of the response. |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | string | No | |
Name | form | string | No | |
Event | form | string | No | |
IsActive | form | bool | No | |
CreatedDateUtc | form | DateTime | No | |
CreatedById | form | string | No | |
LastModifiedDateUtc | form | DateTime | No | |
Config | form | SubscriptionConfig | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Url | form | string | No | |
ContentType | form | string | No | |
Secret | form | string | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
AttemptedDateUtc | form | DateTime | No | |
StatusDescription | form | string | No | |
StatusCode | form | HttpStatusCode | No | |
SubscriptionId | form | string | No | |
Id | form | string | No | |
EventId | form | string | No |
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /sync/webhooks/subscriptions/{Id}/update HTTP/1.1
Host: reportfiling.staging.pwc.de
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<UpdateWebhookSubscription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PwC.Elmaas.Core.Services.Contracts.Webhooks.Requests">
<ContentType>String</ContentType>
<CurrentSecret>String</CurrentSecret>
<Event>String</Event>
<Id>String</Id>
<IsActive>false</IsActive>
<Name>String</Name>
<NewSecret>String</NewSecret>
<PublicKeyXml>String</PublicKeyXml>
<Url>String</Url>
</UpdateWebhookSubscription>
HTTP/1.1 200 OK Content-Type: application/xml Content-Length: length <SubscriptionResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PwC.Elmaas.Core.Services.Contracts.Webhooks.Responses"> <History xmlns:d2p1="http://schemas.datacontract.org/2004/07/ServiceStack.Webhooks.ServiceModel.Types"> <d2p1:SubscriptionDeliveryResult> <d2p1:AttemptedDateUtc>0001-01-01T00:00:00</d2p1:AttemptedDateUtc> <d2p1:EventId>String</d2p1:EventId> <d2p1:Id>String</d2p1:Id> <d2p1:StatusCode>Continue</d2p1:StatusCode> <d2p1:StatusDescription>String</d2p1:StatusDescription> <d2p1:SubscriptionId>String</d2p1:SubscriptionId> </d2p1:SubscriptionDeliveryResult> </History> <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types"> <d2p1:ErrorCode>String</d2p1:ErrorCode> <d2p1:Message>String</d2p1:Message> <d2p1:StackTrace>String</d2p1:StackTrace> <d2p1:Errors> <d2p1:ResponseError> <d2p1:ErrorCode>String</d2p1:ErrorCode> <d2p1:FieldName>String</d2p1:FieldName> <d2p1:Message>String</d2p1:Message> <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d5p1:KeyValueOfstringstring> <d5p1:Key>String</d5p1:Key> <d5p1:Value>String</d5p1:Value> </d5p1:KeyValueOfstringstring> </d2p1:Meta> </d2p1:ResponseError> </d2p1:Errors> <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d3p1:KeyValueOfstringstring> <d3p1:Key>String</d3p1:Key> <d3p1:Value>String</d3p1:Value> </d3p1:KeyValueOfstringstring> </d2p1:Meta> </ResponseStatus> <Subscription xmlns:d2p1="http://schemas.datacontract.org/2004/07/ServiceStack.Webhooks.ServiceModel.Types"> <d2p1:Config> <d2p1:ContentType>String</d2p1:ContentType> <d2p1:Secret>String</d2p1:Secret> <d2p1:Url>String</d2p1:Url> </d2p1:Config> <d2p1:CreatedById>String</d2p1:CreatedById> <d2p1:CreatedDateUtc>0001-01-01T00:00:00</d2p1:CreatedDateUtc> <d2p1:Event>String</d2p1:Event> <d2p1:Id>String</d2p1:Id> <d2p1:IsActive>false</d2p1:IsActive> <d2p1:LastModifiedDateUtc>0001-01-01T00:00:00</d2p1:LastModifiedDateUtc> <d2p1:Name>String</d2p1:Name> </Subscription> </SubscriptionResponse>