API Cloud 10.4 | API Cloud Overview | API Gateway | API Gateway Administration | General Configuration | Transaction Alerts | Configuring Criteria for a Transaction Alert Notification Across Stages
 
Configuring Criteria for a Transaction Alert Notification Across Stages
You can configure alert notifications through email or web hooks when the total transactions reaches a particular limit across all stages.
* To configure the license alert criteria
1. Expand the menu options icon , in the title bar, and select Administration.
2. Select General > Transaction alerts > All stages.
This displays a list of available alert configurations and the corresponding details.
3. Click Add Criteria and provide the following information:
Field
Description
Notify at
Select the usage percentage at which the notification is to be sent.
Notify through
The user can be notified through one or both of the following ways by selecting the appropriate options:
*Email: Select this option and provide a valid email address to which the license alerts are sent. You can add multiple email addresses by clicking .
*Webhook: You have to configure the webhook to invoke a HTTP call back to send the transaction alert notifications. Select this option and provide the following information:
*URL: Mandatory. Specifies the REST endpoint URL to invoke the HTTP call back to.
*Username: The username information to be sent through the Authorization header.
*Password: The username information to be sent through the Authorization header.
*Header key: The HTTP header key that should be included in the header of API requests
*Header value: The HTTP header value that should be included in the header of API requests
Note: You can add multiple key-value pairs by clicking .
4. Click Save.
Schema
When you select the webhook to invoke a HTTP callback to send an alert notification the following response payload is sent in the webhook notification.
{
"type": "object",
"properties": {
"notificationSetForPercentage": {
"type": "integer",
"title": "The notification percentage",
"description": "The transaction limit percentage at which notifications
should be generated.",
"examples": [
90
]
},
"totalTransactions": {
"type": "integer",
"title": "The number of transactions allocated",
"description": "The total number of transactions per month allocated
for a particular customer.",
"examples": [
10000000
]
},
"usedTransactions": {
"type": "integer",
"title": "The number of transactions consumed ",
"description": "The total number of transactions consumed presently
by the consumers.",
"examples": [
1000000
]
},
"percentageUsed": {
"type": "integer",
"title": "The percentage of transaction usage ",
"description": "The rate of transaction usage computed as
usedTransactions/totalTransactions.",
"examples": [
10
]
},
"notificationSentDate": {
"type": "integer",
"title": "The date of notification",
"description": "The date (in long value) at which the notification was
generated for the transaction limit consumption.",
"examples": [
1524646797
]
}
},
"required": [
"notificationSetForPercentage",
"totalTransactions",
"usedTransactions",
"percentageUsed",
"notificationSentDate"
]
}
An example of a sample payload schema would look like:
{
"notificationSetForPercentage": 90,
"totalTransactions": 10000000,
"usedTransactions": 1000000,
"percentageUsed": 10,
"notificationSentDate": 1524646797
}

Copyright © 2015- 2019 | Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.