Thiết lập thông báo giới hạn cho gói giá

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X.
thông tin

Bạn có thể thông báo cho nhà phát triển qua email khi họ sắp hoặc đã đạt đến giới hạn nhất định về gói giá của Gói giá theo gói hoặc Băng tần số lượng lớn mà họ đã mua. Ví dụ: nếu nhà phát triển mua một gói theo băng tần âm lượng có 1.000 lệnh gọi trong một gói, thì bạn có thể thông báo cho họ khi đạt 800 lệnh gọi (80% mức sử dụng) hoặc khi họ đã chi tiêu 500 USD cho các lệnh gọi API.

Để thiết lập thông báo giới hạn cho gói giá bằng API, hãy làm theo các bước sau:

  1. Tuỳ chỉnh mẫu thông báo dùng để thông báo cho nhà phát triển.
  2. Định cấu hình điều kiện và hành động thông báo.

Tuỳ chỉnh mẫu thông báo

Sau đây là một ví dụ về cách tuỳ chỉnh mẫu thông báo mà sẽ được dùng để thông báo cho nhà phát triển. Để biết thêm thông tin, hãy xem bài viết Quản lý mẫu thông báo bằng 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

Định cấu hình điều kiện và thao tác thông báo

Định cấu hình điều kiện và thao tác thông báo bằng API, như mô tả trong bài viết Định cấu hình các điều kiện và thao tác thông báo bằng API.

Để kích hoạt thông báo về hạn mức gói giá, hãy đặt các thuộc tính sau:

  • RATEPLAN – Loại thông báo cần gửi.
  • PUBLISHED – Đặt thuộc tính này thành TRUE để kích hoạt thông báo về các gói giá đã đăng.

Sau đó, hãy chỉ định một trong các thuộc tính sau:

  • Transactions - Số lượng giao dịch. Ví dụ: thông báo cho nhà phát triển khi họ đạt 800 lượt giao dịch. Phải là một giá trị số nguyên và chỉ được phép sử dụng các toán tử > và =.
  • FeeExposure – Số tiền hoặc điểm tích luỹ được từ các giao dịch. Phải là một giá trị số nguyên và chỉ được phép sử dụng toán tử > và =. FeeExposure không bao gồm số tiền phí thiết lập, phí định kỳ hoặc phí chấm dứt. Ví dụ: thông báo cho nhà phát triển khi chi phí giao dịch API của họ đạt 500 đô la Mỹ. Cách tính FeeExposure sẽ khác nhau tuỳ theo thuế suất.

Tải trọng sau đây kích hoạt một thông báo qua email khi số lượng giao dịch đạt đến 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