Configurare una notifica di limite per un piano tariffario

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X.
info

Puoi inviare una notifica agli sviluppatori via email quando si avvicinano o hanno raggiunto un determinato limite di un piano tariffario a fasce di volume o in bundle che hanno acquistato. Ad esempio, se gli sviluppatori acquistano un piano a fasce di volume con 1000 chiamate in un bundle, puoi inviare loro una notifica quando raggiungono 800 chiamate (80% di utilizzo) o quando hanno speso 500 $per le chiamate API.

Per configurare una notifica di limite per un piano tariffario utilizzando l'API:

  1. Personalizza il modello di notifica che verrà utilizzato per inviare la notifica allo sviluppatore.
  2. Configura la condizione e l'azione di notifica.

Personalizzare il modello di notifica

Di seguito è riportato un esempio di come personalizzare il modello di notifica che verrà utilizzato per inviare la notifica allo sviluppatore. Per ulteriori informazioni, consulta Gestire i modelli di notifica utilizzando l'API.

$ curl -H "Content-Type: application/json " -X POST -d \    
'{
    "name": "RATE_PLAN_LIMIT_TEMPLATE",
    "subject": "Nearing your rate plan limit",
    "htmlImage": "<p>Hi ${developer.name} - Wanted to let you know that you have used 800 API calls from your ${ratePlan.displayName} rate plan, which started on ${ratePlan.startDate} under the ${ratePlan.monetizationPackage.displayName} package and ${ratePlan.monetizationPackage.products.displayName} product. Just a friendly reminder that your API calls will be charged double after you cross 1000 calls. Thanks for using the API!</p>",
    "source": "Postman API call"
    }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/notification-email-templates" \
    -u email:password

Configurare la condizione e l'azione di notifica

Configura una condizione e un'azione di notifica utilizzando l'API, come descritto in Configurare le condizioni e le azioni di notifica utilizzando l'API.

Per attivare la notifica per un limite del piano tariffario, imposta i seguenti attributi:

  • RATEPLAN - Tipo di notifica da inviare.
  • PUBLISHED - Imposta questo attributo su TRUE per attivare le notifiche sui piani tariffari pubblicati.

Poi, specifica uno dei seguenti attributi:

  • Transactions - Numero di transazioni. Ad esempio, invia una notifica agli sviluppatori quando raggiungono 800 transazioni. Deve essere un valore intero e sono consentiti solo gli operatori > e = consentiti.
  • FeeExposure - Importo in dollari o punti accumulati sulle transazioni. Deve essere un valore intero e sono consentiti solo gli operatori > e =. FeeExposure non include gli importi delle commissioni di configurazione, ricorrenti o di annullamento. Ad esempio, invia una notifica agli sviluppatori quando il costo delle loro transazioni API raggiunge 500 $. FeeExposure calcoli variano in base all'aliquota fiscale.

Il seguente payload attiva una notifica via email quando il numero di transazioni raggiunge 800:

$ curl -H "Content-Type:application/json" -X POST -d \
    '{
    "notificationCondition": [
      {
        "attribute": "RATEPLAN",
        "value": "{RATE_PLAN_ID}"
      },
      {
        "attribute": "PUBLISHED",
        "value": "TRUE"
      },
      {
        "attribute": "Transactions",
        "value": "= 800"
      }     
    ],
   "actions": [{
          "actionAttribute": "DEV_ID",
          "value": "ANY",
          "templateId": "{EMAIL_TEMPLATE_ID}"
        }]
  }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/notification-conditions" \
    -u email:password