إعداد إشعار للحد الأقصى لخطة أسعار

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلىمستندات Apigee X. info

يمكنك إشعار المطوّرين عبر البريد الإلكتروني عندما يقتربون من حدّ معيّن أو يصلون إليه في خطة بطاقة أسعار "النطاقات حسب الحجم" أو "الحزمة" التي اشتروها. على سبيل المثال، إذا اشترى المطوّرون خطة "النطاقات حسب الحجم" تتضمّن 1,000 طلب في حزمة، يمكنك إشعارهم عندما يصلون إلى 800 طلب (نسبة استخدام ‎80%) أو عندما ينفقون 500 دولار أمريكي على طلبات واجهة برمجة التطبيقات.

لإعداد إشعار بالحدّ الأقصى لخطة أسعار باستخدام واجهة برمجة التطبيقات، اتّبِع الخطوات التالية:

1. خصِّص نموذج الإشعار الذي سيتم استخدامه لـ إشعار المطوّر.
2. اضبط شرط الإشعار والإجراء.

تخصيص نموذج الإشعار

في ما يلي مثال على كيفية تخصيص نموذج الإشعار الذي سيتم استخدامه لإشعار المطوّر. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة نماذج الإشعارات باستخدام واجهة برمجة التطبيقات.

$ 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

ضبط شرط الإشعار والإجراء

اضبط شرط الإشعار والإجراء باستخدام واجهة برمجة التطبيقات، كما هو موضّح في ضبط شروط الإشعارات والإجراءات باستخدام واجهة برمجة التطبيقات.

لتفعيل الإشعار بالحدّ الأقصى لخطة أسعار، اضبط السمتَين التاليتَين:

• RATEPLAN : نوع الإشعار الذي سيتم إرساله
• PUBLISHED - اضبط هذه السمة على "صحيح" لتفعيل الإشعارات بشأن خطط الأسعار المنشورة.

بعد ذلك، حدِّد إحدى السمتَين التاليتَين:

• Transactions : عدد المعاملات على سبيل المثال، أرسِل إشعارًا إلى المطوّرين عندما يصلون إلى 800 معاملة. يجب أن تكون القيمة عددًا صحيحًا، ولا يُسمح إلا بعاملي التشغيل > و=.
• FeeExposure : مبلغ الدولارات أو النقاط المتراكمة في المعاملات يجب أن تكون القيمة عددًا صحيحًا، ولا يُسمح إلا بعاملي التشغيل > و=. FeeExposure لا يشمل مبالغ رسوم الإعداد أو الرسوم المتكرّرة أو رسوم الإنهاء. على سبيل المثال، أرسِل إشعارًا إلى المطوّرين عندما تصل تكلفة معاملات واجهة برمجة التطبيقات إلى 500 دولار أمريكي. تختلف عمليات احتساب FeeExposure حسب معدّل الضريبة.

تعمل الحمولة التالية على تفعيل إشعار عبر البريد الإلكتروني عندما يصل عدد المعاملات إلى 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