GET | /async/webhooks/subscriptions/{Id} |
---|
/** @description Specifies a request to retrieve a webhook subscription by its unique identifier, and retrieve its details. */
// @Api(Description="Specifies a request to retrieve a webhook subscription by its unique identifier, and retrieve its details.")
export class GetWebhookSubscriptionBase implements IGet
{
/** @description The unique identifier of the subscriber. */
// @ApiMember(Description="The unique identifier of the subscriber.", IsRequired=true, Name="Id")
public id: string;
public constructor(init?: Partial<GetWebhookSubscriptionBase>) { (Object as any).assign(this, init); }
}
export class SubscriptionConfig
{
public url: string;
public contentType: string;
public secret: string;
public constructor(init?: Partial<SubscriptionConfig>) { (Object as any).assign(this, init); }
}
export class WebhookSubscription
{
public id: string;
public name: string;
public event: string;
public isActive: boolean;
public createdDateUtc: string;
public createdById: string;
public lastModifiedDateUtc: string;
public config: SubscriptionConfig;
public constructor(init?: Partial<WebhookSubscription>) { (Object as any).assign(this, init); }
}
export class SubscriptionDeliveryResult
{
public attemptedDateUtc: string;
public statusDescription: string;
public statusCode: HttpStatusCode;
public subscriptionId: string;
public id: string;
public eventId: string;
public constructor(init?: Partial<SubscriptionDeliveryResult>) { (Object as any).assign(this, init); }
}
/** @description Represents a service response that encapsulates a webhook subscription. */
// @Api(Description="Represents a service response that encapsulates a webhook subscription.")
export class SubscriptionResponse
{
/** @description 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. */
// @ApiMember(Description="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.", Name="Subscription")
public subscription: WebhookSubscription;
/** @description The history of the subscription event. */
// @ApiMember(Description="The history of the subscription event.", Name="History")
public history: SubscriptionDeliveryResult[];
/** @description The status of the response. */
// @ApiMember(Description="The status of the response.", Name="ResponseStatus")
public responseStatus: ResponseStatus;
public constructor(init?: Partial<SubscriptionResponse>) { (Object as any).assign(this, init); }
}
/** @description Represents a request to retrieve a webhook subscription by its unique identifier, and retrieve its details in an asynchronous operation. */
// @Api(Description="Represents a request to retrieve a webhook subscription by its unique identifier, and retrieve its details in an asynchronous operation.")
export class GetWebhookSubscriptionAsync extends GetWebhookSubscriptionBase
{
public constructor(init?: Partial<GetWebhookSubscriptionAsync>) { super(init); (Object as any).assign(this, init); }
}
TypeScript GetWebhookSubscriptionAsync DTOs
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
GET /async/webhooks/subscriptions/{Id} HTTP/1.1 Host: reportfiling.staging.pwc.de Accept: text/jsv
HTTP/1.1 200 OK Content-Type: text/jsv Content-Length: length { subscription: { id: String, name: String, event: String, isActive: False, createdDateUtc: 0001-01-01, createdById: String, lastModifiedDateUtc: 0001-01-01, config: { url: String, contentType: String, secret: String } }, history: [ { attemptedDateUtc: 0001-01-01, statusDescription: String, statusCode: Continue, subscriptionId: String, id: String, eventId: String } ], responseStatus: { errorCode: String, message: String, stackTrace: String, errors: [ { errorCode: String, fieldName: String, message: String, meta: { String: String } } ], meta: { String: String } } }