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.
Truy cập vào tài liệu 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 đạt đến hoặc đã đạt đến một hạn mức nhất định của gói thẻ giá theo Gói hoặc theo Bậc số lượng mà họ đã mua. Ví dụ: nếu nhà phát triển mua một gói theo mức sử dụng với 1.000 lượt gọi trong một gói, bạn có thể thông báo cho họ khi họ đạt đến 800 lượt gọi (80% mức sử dụng) hoặc khi họ đã chi 500 USD cho các lệnh gọi API.

Để thiết lập thông báo về hạn mức cho một kế hoạch giá bằng API, hãy thực hiện các bước sau:

  1. Tuỳ chỉnh mẫu thông báo sẽ được 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 của thông báo.

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

Sau đây là ví dụ về cách tuỳ chỉnh mẫu thông báo 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à hành động thông báo

Định cấu hình điều kiện và hành động của thông báo bằng API, như mô tả trong phần Định cấu hình điều kiện và hành động của thông báo bằng API.

Để kích hoạt thông báo cho một hạn mức của kế hoạch 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 kế hoạch giá đã xuất bản.

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

  • Transactions – Số giao dịch. Ví dụ: thông báo cho nhà phát triển khi họ đạt đến 800 giao dịch. Phải là giá trị số nguyên và chỉ được phép dùng toán tử > và =.
  • FeeExposure – Số tiền bằng đô la hoặc số điểm tích luỹ được trong các giao dịch. Phải là giá trị số nguyên và chỉ được phép 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 đến 500 đô la. Việc tính toán FeeExposure sẽ khác nhau tuỳ thuộc vào thuế suất.

Tải trọng sau đây sẽ kích hoạ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