درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
مقدمه
در طرح کارت نرخ، هزینه هر تراکنش از توسعهدهنده کسر میشود. برای این نوع طرح، باید جزئیات بیشتری مثل مدل شارژ و قیمتگذاری مدل شارژ ارائه دهید.
درصورت تمایل، میتوانید طرحی رایگان با ویژگیهای ممتاز برای محصولات تکی (بهجای بسته API) مشخص کنید — این کار را فقط برای طرح محصول-محور میتوانید انجام دهید.
کارمزدهای تکرارشونده چه زمانی کسر میشوند و طرحهای دستهای چه زمانی بازنشانی میشوند؟
طرحهای نرخ میتواند شامل کارمزدهای تکرارشونده و همچنین بستههای API (طرحهای «حجمی» و «بستهای») باشد، که هر دو شامل زمانهای مشخصی برای کسر کارمزدها و بازنشانی طرحهای بستهای به صفر است. جدول زیر توضیح میدهد که کارمزدهای تکرارشونده چه زمانی کسر میشوند و تعداد دستهها چه زمانی بازنشانی میشود. اگر برنامههای توسعهدهنده بهدلیل رسیدن به حد معینی از تراکنش از انجام فراخوانیهای بیشتر میانای برنامهسازی کاربردی مسدود شوند، این زمانها زمانهایی هستند که تعداد فراخوانیهای میانای برنامهسازی کاربردی به صفر بازنشانی میشود و برنامهها میتوانند دوباره فراخوانی انجام دهند.
| اگر طرح دارای… | …این اتفاق میافتد |
|---|---|
|
کارمزد تکرارشونده و بازنشانی طرح دستهای در اولین روز ماه (پیشفرض) انجام میشود. برای تکرار ماهانه در روزی خاص، بااستفاده از مدیریت
API طرح قیمت ایجاد کنید و روز را با دارایی |
|
کارمزد تکرارشونده و بازنشانی طرح دستهای هر ۷ روز پساز تاریخ شروع طرح نرخ توسعهدهنده انجام میشود. |
|
کارمزد تکرارشونده و بازنشانی طرح دستهای هر X روز پساز تاریخ شروع طرح نرخ توسعهدهنده رخ میدهد. |
|
طرحهای دستهای براساس «پایه تجمیع» تعریفشده در کارت نرخ بازنشانی میشوند. برای مثال، اگر توسعهدهندهای طرح نرخی را در روز ۱۹ ماه شروع کند و «مبنای تجمیع» هر ۱ ماه باشد، استفاده از بسته هر ماه در روز ۱۹ بازنشانی میشود. توجه داشته باشید که روز ماه ممکن است همیشه یکسان نباشد. برای مثال، اگر طرح نرخ در ۳۱ دسامبر شروع شود، تاریخ بازنشانی در فوریه غیرسال کبیسه به ۲۸ تغییر میکند زیرا فوریه فقط ۲۸ روز دارد. سپس ۲۸ام بهعنوان روز بازنشانی برای همیشه باقی میماند. |
پیکربندی طرحهای کارت نرخ بااستفاده از واسط کاربر
طرحهای کارت نرخ را همانطور که در زیر توضیح داده شده است پیکربندی کنید.
Edge
برای پیکربندی طرح کارت نرخ، هنگام ایجاد یا ویرایش طرح نرخ، نوع طرح نرخ کارت نرخ یا کارت نرخ و سهم درآمد را انتخاب کنید و در بخش کارت نرخ یکی از مدلهای شارژ زیر را انتخاب کنید:
| مدل شارژ | شرح |
| نرخ ثابت | نرخ ثابتی برای هر تراکنش از توسعهدهنده کسر میشود. |
| حجم دستهبندیشده | نرخ متغیری بسته به حجم تراکنشها از توسعهدهنده کسر میشود. |
| بسته | توسعهدهنده برای هر بسته تراکنش مبلغی ثابت ازقبل پرداخت میکند. توسعهدهنده مبلغ تعیینشده را چه بسته بهطور کامل استفاده شود چه نشود پرداخت میکند.
توجه: این گزینه زمانی که «کارت نرخ» و «سهم درآمد» را انتخاب میکنید، دردسترس نیست. |
سپس، اطلاعات زیر را براساس مدل شارژ انتخابی پیکربندی کنید.
| مدل شارژ | فیلد | شرح |
| همه | بسامد محاسبه | دوره زمانی که حجم تراکنشها (یا حجم مربوط به مشخصه سفارشی) در آن محاسبه میشود. تعداد ماهها را انتخاب کنید (۱ تا ۲۴ ماه). |
| نرخ ثابت | نرخ ثابت | نرخ کسرشده برای هر تراکنش. عدد اعشاری (با حداکثر چهار رقم اعشار) وارد کنید.
توجه: میتوانید تعداد رقمهای اعشاری را که میتوان برای نرخ کسرشده بااستفاده از «میانای برنامهسازی کاربردی» (نه رابط کاربری) مشخص کرد پیکربندی کنید. برای جزئیات بیشتر، پیکربندی تعداد رقمهای اعشاری برای نرخهای طرح نرخ را ببینید. برای مثال، اگر ۰٫۱۰ وارد کنید و واحد پول دلار امریکا باشد، برای هر تراکنش ۰٫۱۰ دلار از توسعهدهنده کسر میشود (یا اگر براساس مشخصه سفارشی مثل تعداد بایتهای منتقلشده در تراکنش باشد، برای انتقال تعداد مشخصشده بایت، ۰٫۱۰ دلار از توسعهدهنده کسر میشود). |
| حجم دستهبندیشده | باندهای حجم | یک یا چند محدوده حجم تراکنش (یا براساس مشخصه مشتری) (هر محدوده یک «نوار حجم» است) برای مدل شارژ براساس نوار حجم. برای هر گروه حجم میتوان نرخی تعیین کرد. این نرخ برای همه تراکنشها در محدوده حجم مربوطه اعمال میشود. حد بالای اولین دسته را مشخص کنید، برای مثال، تا ۱۰۰۰ (حد پایین ازپیشتنظیمشده و بزرگتر از ۰ است).
برای افزودن گروههای بیشتر، روی +جدید کلیک کنید. حد بالایی گروه نهایی را خالی بگذارید تا نشان دهید همه تراکنشها بالاتر از این سطح هستند. توجه: میتوانید تعداد رقمهای اعشاری را که میتوان برای نرخ کسرشده بااستفاده از «میانای برنامهسازی کاربردی» (نه رابط کاربری) مشخص کرد پیکربندی کنید. برای جزئیات بیشتر، پیکربندی تعداد رقمهای اعشاری برای نرخهای طرح نرخ را ببینید. برای مثال، اگر دو نوار حجم را در بخش «نوار حجم» مشخص کنید (>0-1000 و 1000 و بالاتر)، ممکن است برای نوار حجم >0-1000 مقدار 0.15 و برای نوار حجم 1000 و بالاتر مقدار 0.10 را وارد کنید. اگر واحد پول انتخابشده دلار امریکا باشد، نرخ برای ۱۰۰۰ تراکنش اول ۰٫۱۵ دلار برای هر تراکنش است و برای بیشاز ۱۰۰۰ تراکنش، نرخ ۰٫۱۰ دلار برای هر تراکنش است. |
| بسته | قیمتهای بسته میانای برنامهسازی کاربردی | تعداد تراکنشها در یک بسته (یا عددی مربوط به یک مشخصه سفارشی مثل تعداد کل بایتهای منتقلشده در یک بسته). برای هر دسته میتوان قیمت تعیین کرد. قیمت برای کل بسته اعمال میشود. حد بالای بسته اول را مشخص کنید، برای مثال، تا ۱۰۰۰ (حد پایین ازپیش روی بیشتر از ۰ تنظیم شده است).
برای افزودن بستههای اضافی، روی +جدید کلیک کنید. باید برای آخرین دسته، حد بالایی مشخص کنید، مگر اینکه بخواهید برای تراکنشهای نامحدود در دسته آخر، مبلغ ثابتی از توسعهدهنده دریافت کنید. توجه: میتوانید تعداد رقمهای اعشاری را که میتوان برای نرخ کسرشده بااستفاده از «میانای برنامهسازی کاربردی» (نه رابط کاربری) مشخص کرد پیکربندی کنید. برای جزئیات بیشتر، پیکربندی تعداد رقمهای اعشاری برای نرخهای طرح نرخ را ببینید. برای مثال، اگر دو دسته را در بخش «اندازه دسته» مشخص کنید (بزرگتر از ۰ تا ۱۰۰۰، و بزرگتر از ۱۰۰۰ تا ۲۰۰۰)، میتوانید ۵۰ را برای دسته بزرگتر از ۰ تا ۱۰۰۰، و ۴۰ را برای دسته بزرگتر از ۱۰۰۰ تا ۲۰۰۰ وارد کنید. اگر ارز انتخابشده دلار امریکا باشد، قیمت بسته اول ۵۰ دلار و قیمت بسته دوم ۴۰ دلار است. توسعهدهنده صرفنظر از اینکه چند تراکنش در بسته استفاده میکند، قیمت بسته ذیربط را پرداخت میکند (یعنی توسعهدهنده بهمحض تکمیل اولین تراکنش در بسته، قیمت بسته را پرداخت میکند). |
اگر مشخصههای سفارشی برای محصول API خود تعریف کردهاید، میتوانید پارامتر ردهبندی سفارشی را پیکربندی کنید تا براساس مشخصه سفارشی در هر تراکنش، از توسعهدهنده برنامه هزینه دریافت کنید. برای مثال، اگر طرحی راهاندازی کنید که در آن برای هر تراکنش از توسعهدهنده کارمزد دریافت میکنید، میتوانید نرخ طرح را براساس یک مشخصه سفارشی، مثل تعداد بایتهای منتقلشده در زیرینه که میتواند برای هر تراکنش متفاوت باشد، تنظیم کنید.
در این مورد، استفاده از پارامتر ردهبندی سفارشی را انتخاب کنید و مشخصه سفارشی را از فهرست انتخاب کنید. برای اطلاعات بیشتر، پیکربندی طرح نرخ با مشخصههای سفارشی را ببینید.
Classic Edge (ابر خصوصی)
برای پیکربندی طرحهای کارت نرخ بااستفاده از «واسط کاربر Classic Edge»:
- مراحل ایجاد طرح نرخ را دنبال کنید.
- در منو کرکرهای «نوع طرح نرخ»، کارت نرخ را برای پیکربندی مدل درآمد انتخاب کنید.
- اگر بسته API انتخابشده شامل چندین محصول API است، یکی از گزینههای زیر را انتخاب کنید:
توجه: اگر بسته API شامل یک محصول API باشد، میتوانید از این مرحله رد شوید.
- طرحهای مختص محصول برای پیکربندی جزئیات طرح نرخ برای هر محصول API بهصورت جداگانه.
- طرح عمومی برای همه محصولات برای پیکربندی جزئیات طرح نرخ برای همه محصولات API.
- برای طرح نرخ عمومی یا برای هر طرح نرخ مختص محصول API، روی جدول نرخ کلیک کنید.
توجه: هنگام پیکربندی طرحهای مختص محصول API، باید طرح کارت نرخ را برای هر محصول API بهصورت جداگانه پیکربندی کنید.

پنجره «جدول نرخ خدمات» باز میشود.

- طرحی رایگان با ویژگیهای ممتاز برای محصول میانای برنامهسازی کاربردی راهاندازی کنید. طرح «رایگان با امکانات ویژه» به توسعهدهندگان امکان میدهد
از محصول API در یک دوره زمانی یا براساس میزان استفاده بهصورت رایگان استفاده کنند.
اطلاعات زیر را وارد کنید:
فیلد شرح محصول رایگانویژه؟ میزان دوره رایگان. یکی از دکمههای رادیویی زیر را انتخاب کنید:
- براساس مقدار. دوره رایگان براساس مقدار مشخصشده در فیلد «حجم» است.
- براساس مدت. دوره کارمزد براساس فاصله زمانی مشخصشده در فیلد «مدت Freemium» است.
- هرکدام زودتر فرا برسد. دوره رایگان زمانی بهپایان میرسد که یا مقدار در فیلد حجم یا فاصله زمانی در فیلد «مدت زمان Freemium» به حد مجاز برسد، هرکدام زودتر اتفاق بیفتد.
- نه. این طرح رایگان نیست. این گزینه پیشفرض است.
حجم رایگانپایه حجم تراکنشها (یا حجم مربوط به یک مشخصه سفارشی که در خطمشی ضبط تراکنش ثبت شده است) که توسعهدهندگان برای آنها هزینه دریافت نمیکنند. حجم برای محصول API اندازهگیری میشود. عدد حجمی، مثلاً ۵۰۰۰، وارد کنید. این یعنی وقتی توسعهدهندگان طرح را شروع میکنند، برای ۵۰۰۰ تراکنش اول (یا برای ۵۰۰۰ استفاده اول از عنصر مرتبط با مشخصه سفارشی) هزینهای از آنها دریافت نمیشود. این فیلد فقط درصورتی فعال میشود که در فیلد «محصول Freemium؟»، گزینه «براساس مقدار» یا «هرکدام زودتر تمام شد» را انتخاب کنید.
مدت رایگانپایه فاصله زمانی که درطول آن از توسعهدهندگان هزینه دریافت نمیشود. عددی وارد کنید و دوره زمانی را انتخاب کنید، برای مثال، ۱ ماه. این یعنی توسعهدهندگان برای ۱ ماه هزینهای پرداخت نمیکنند. این فیلد فقط درصورتی فعال میشود که در فیلد «محصول Freemium؟»، گزینه «براساس مدت» یا «هرکدام زودتر فرا برسد» را انتخاب کنید.
- یکی از مدلهای شارژ زیر را انتخاب کنید:
- نرخ ثابت. در این مدل، توسعهدهنده برای هر تراکنش نرخ ثابتی پرداخت میکند.
- حجم دستهبندیشده. در این مدل، توسعهدهنده براساس حجم تراکنشها نرخ متغیری را پرداخت میکند.
- بستهها. در این مدل، توسعهدهنده برای هر بسته تراکنش مبلغ ثابتی (پیشپرداخت) پرداخت میکند. توسعهدهنده مبلغ تعیینشده را چه بسته بهطور کامل استفاده شود چه نشود پرداخت میکند.
برای مدل نرخ ثابت: اطلاعات زیر را در بخش «قیمتگذاری» پنجره «کارت نرخ عمومی» وارد کنید:
فیلد شرح اپراتور (یا سازمان) نام سازمان شما. این فیلد بااستفاده از مقدار فیلد «اپراتور» (یا «سازمان») در نمایه سازمان ازپیش تنظیم شده است.
کشور کشور محل فعالیت سازمان شما. این فیلد بااستفاده از مقدار فیلد «کشور» در نمایه سازمان ازپیش تنظیم شده است.
نرخ ثابت نرخ کسرشده برای هر تراکنش. عدد اعشاری (با حداکثر چهار رقم اعشار) وارد کنید.
توجه: میتوانید تعداد رقمهای اعشاری را که میتوان برای نرخ کسرشده بااستفاده از «میانای برنامهسازی کاربردی» (نه رابط کاربری) مشخص کرد پیکربندی کنید. برای جزئیات بیشتر، پیکربندی تعداد جایگاههای اعشاری برای نرخهای طرح نرخ را ببینید.
برای مثال، اگر ۰٫۱۰ وارد کنید و واحد پول دلار امریکا باشد، برای هر تراکنش ۰٫۱۰ دلار از توسعهدهنده کسر میشود (یا اگر براساس مشخصه سفارشی مثل تعداد بایتهای منتقلشده در تراکنش باشد، برای انتقال تعداد مشخصشده بایت ۰٫۱۰ دلار از توسعهدهنده کسر میشود).
برای مدل دستهبندی براساس حجم: پنجره «کارت نرخ عمومی» فیلدهای اضافی را نمایش میدهد که از آنها برای تعیین مبنای تجمیع و تعیین «دستههای حجم» استفاده میکنید، یعنی محدودههای حجم تراکنش که میتوانید نرخهای مختلف را برای آنها اعمال کنید.
این نوع طرح معمولاً برای تشویق توسعهدهندگان به تولید حجمهای بالاتر با ارائه نرخهای تخفیفدار برای حجمهای بالاتر تنظیم میشود.

اطلاعات زیر را در پنجره «کارت نرخ عمومی» وارد کنید:
فیلد شرح مبنای انبوهش دوره زمانی که حجم تراکنشها (یا حجم مربوط به مشخصه سفارشی) در آن تجمیع میشود. از حجم تجمیعی برای شناسایی باند حجم و نرخ اعمالشده برای هر تراکنش استفاده میشود. تعداد ماهها را انتخاب کنید (۱ تا ۱۲ ماه).
برای جزئیات مربوط به زمان بازنشانی بستهها، به کارمزدهای تکرارشونده چه زمانی کسر میشوند و طرحهای بسته چه زمانی بازنشانی میشوند؟ مراجعه کنید.
باند میزان صدا یک یا چند محدوده حجم تراکنش (یا براساس مشخصه مشتری) (هر محدوده یک «نوار حجم» است). به هر گروه حجم میتوان نرخی اختصاص داد (این نرخ را در فیلد «گروههای حجم» در بخش «قیمتگذاری» تنظیم میکنید.) این نرخ برای همه تراکنشها در بازه حجم ذیربط اعمال میشود. حد بالایی اولین باند را مشخص کنید، برای مثال، تا ۱۰۰۰ (حد پایین ازپیشتنظیمشده و بزرگتر از ۰ است). برای افزودن گروه دوم، برای مثال، بیشتر از ۱۰۰۰ تا ۲۰۰۰، روی + کلیک کنید. برای افزودن باندهای بیشتر، روی + کلیک کنید. میتوانید حد بالای گروه نهایی را خالی بگذارید تا نشان دهید همه تراکنشها بالاتر از این سطح هستند.

قیمتگذاری اپراتور (یا سازمان) نام سازمان شما. این فیلد بااستفاده از مقدار فیلد «اپراتور» (یا «سازمان») در «نمایه سازمان» ازپیش تنظیم شده است.
کشور کشور محل فعالیت سازمان شما. این فیلد بااستفاده از مقدار فیلد «کشور» در «نمایه سازمان» ازپیش تنظیم شده است.
واحد پول واحد پول «پایه» یا حسابداری که سازمانتان استفاده میکند. این فیلد بااستفاده از مقدار فیلد «واحد پول» در «نمایه سازمان» ازپیش تنظیم شده است، اما میتوان آن را در اینجا تغییر داد.
باندهای حجم نرخ برای یک گروه حجم. نرخی را برای هر نوار حجم مشخص میکنید. برای هر باند، عدد اعشاری (با حداکثر چهار رقم اعشار) وارد کنید.
توجه: میتوانید تعداد جایگاههای اعشاری را که میتوان برای نرخ نوار حجم بااستفاده از «میانای برنامهسازی کاربردی» (نه رابط کاربری) مشخص کرد پیکربندی کنید. برای جزئیات بیشتر، پیکربندی تعداد جایگاههای اعشاری برای نرخهای طرح نرخ را ببینید.
برای مثال، اگر دو نوار حجم را در بخش «نوار حجم» مشخص کنید (بیشتر از ۰ تا ۱۰۰۰، و ۱۰۰۰ و بیشتر)، ممکن است برای نوار حجم بیشتر از ۰ تا ۱۰۰۰ مقدار ۰٫۱۵ و برای نوار حجم ۱۰۰۰ و بیشتر مقدار ۰٫۱۰ را وارد کنید. اگر واحد پول انتخابشده دلار امریکا باشد، نرخ برای ۱۰۰۰ تراکنش اول ۰٫۱۵ دلار برای هر تراکنش است و برای بیشاز ۱۰۰۰ تراکنش، نرخ ۰٫۱۰ دلار برای هر تراکنش است.

برای مدل دستهای: پنجره «کارت نرخ عمومی» فیلدهای اضافهای را نمایش میدهد که از آنها برای مشخص کردن مبنای تجمیع (دوره زمانی که توسعهدهنده میتواند از دسته تراکنشها استفاده کند) و برای مشخص کردن اطلاعات مربوط به دسته مثل اندازه دسته استفاده میکنید.

اطلاعات زیر را در پنجره «کارت نرخ عمومی» وارد کنید:
فیلد شرح مبنای انبوهش مدت زمانی که توسعهدهنده میتواند از بسته تراکنشها استفاده کند (یا از بسته مبتنی بر مشخصه سفارشی استفاده کند). تعداد ماهها را انتخاب کنید (۱ تا ۱۲ ماه). پساز این دوره، طرح منقضی میشود و توسعهدهنده باید طرح (و بستهها) را دوباره خریداری کند.
برای جزئیات مربوط به زمان بازنشانی بستهها، به کارمزدهای تکرارشونده چه زمانی کسر میشوند و طرحهای بسته چه زمانی بازنشانی میشوند؟ مراجعه کنید.
اندازه دسته تعداد تراکنشها در یک بسته (یا عددی مربوط به یک مشخصه سفارشی مثل تعداد کل بایتهای منتقلشده در یک بسته). برای هر دسته میتوان قیمتی تعیین کرد (این قیمت را در فیلد «اندازه دسته» در بخش «قیمتگذاری» تنظیم میکنید.) این قیمت برای کل بسته اعمال میشود. حد بالای بسته اول را مشخص کنید، برای مثال، تا ۱۰۰۰ (حد پایین ازپیشتنظیمشده و بزرگتر از ۰ است). برای افزودن دسته دوم، برای مثال، بیشتر از ۱۰۰۰ تا ۲۰۰۰، روی + کلیک کنید. برای افزودن دستههای بیشتر، روی + کلیک کنید. باید برای آخرین دسته، حد بالایی تعیین کنید، مگر اینکه بخواهید برای تراکنشهای نامحدود در دسته آخر، مبلغ ثابتی از توسعهدهنده کسر کنید.

قیمتگذاری اپراتور (یا سازمان) نام سازمان شما. این فیلد بااستفاده از مقدار فیلد «اپراتور» (یا «سازمان») در «نمایه سازمان» ازپیش تنظیم شده است.
کشور کشور محل فعالیت سازمان شما. این فیلد بااستفاده از مقدار فیلد «کشور» در «نمایه سازمان» ازپیش تنظیم شده است.
واحد پول واحد پول «پایه» یا حسابداری که سازمانتان استفاده میکند. این فیلد بااستفاده از مقدار فیلد «واحد پول» در «نمایه سازمان» ازپیش تنظیم شده است، اما میتوان آن را در اینجا تغییر داد.
اندازه بسته (قیمت) قیمت بسته. شما برای هر بسته قیمتی تعیین میکنید. عدد اعشاری (با حداکثر چهار رقم اعشار) وارد کنید.
توجه: میتوانید تعداد رقمهای اعشاری را که میتوان برای نرخ بسته بااستفاده از «میانای برنامهسازی کاربردی» (نه رابط کاربری) مشخص کرد پیکربندی کنید. برای جزئیات بیشتر، پیکربندی تعداد جایگاههای اعشاری برای نرخهای طرح نرخ را ببینید.
برای مثال، اگر دو دسته را در بخش «اندازه دسته» مشخص کنید (بزرگتر از ۰ تا ۱۰۰۰، و بزرگتر از ۱۰۰۰ تا ۲۰۰۰)، ممکن است ۵۰ را برای دسته بزرگتر از ۰ تا ۱۰۰۰، و ۴۰ را برای دسته بزرگتر از ۱۰۰۰ تا ۲۰۰۰ وارد کنید. اگر واحد پول انتخابشده دلار امریکا باشد، قیمت بسته اول ۵۰ دلار و قیمت بسته دوم ۴۰ دلار است. صرفنظر از اینکه توسعهدهنده چند تراکنش در بسته استفاده میکند، قیمت بسته مربوطه از توسعهدهنده کسر میشود (یعنی بهمحض اینکه اولین تراکنش در بسته تکمیل شود، قیمت بسته از توسعهدهنده کسر میشود.)

- برای ذخیره کردن جزئیات کارت نرخ و بازگشت به پنجره «طرح نرخ استاندارد»، روی اعمال و بستن کلیک کنید.
- برای طرحهای نرخ ویژه محصول «میانای برنامهسازی کاربردی»، جزئیات طرح نرخ را برای محصولات «میانای برنامهسازی کاربردی» اضافی، درصورت نیاز، پیکربندی کنید.
پیکربندی طرح کارت نرخ بااستفاده از API
جزئیات طرح کارت نرخ را بااستفاده از API، همانطور که در بخشهای زیر توضیح داده شده است، پیکربندی کنید.
مشخص کردن جزئیات طرح جدول نرخ خدمات بااستفاده از API
وقتی طرح نرخ را ایجاد میکنید، جزئیات طرح کارت نرخ را مشخص میکنید. جزئیات را در
دارایی ratePlanDetails در بدنه درخواست در تماس با
/organizations/{org_name}/monetization-packages/{package_id}/rate-plans مشخص میکنید. آنچه در
دارایی ratePlanDetails مشخص میکنید، به مدل شارژ انتخابی شما بستگی دارد:
نرخ ثابت، حجم دستهبندیشده، یا بستهها.
مشخص کردن مدل شارژ نرخ ثابت
برای پیادهسازی مدل شارژ نرخ ثابت، موارد زیر را در جزئیات طرح نرخ مشخص میکنید:
- پارامتر ردهبندی که نشان میدهد طرح نرخ براساس تراکنشها
(
VOLUME) یا براساس مشخصه سفارشی (برای نمونه،MINT_CUSTOM_ATTRIBUTE_1) است.VOLUMEپیشفرض است. - نوع اندازهگیری (
UNIT) که نشان میدهد نرخ بهازای هر واحد ثابت است (یعنی براساس حجم تراکنشها نیست، همانطور که در مدل شارژ دستهای یا دستههای حجمی وجود دارد). - دوره سررسید پرداخت (برای مثال، ۳۰ روز).
- شناسه سازمان شما.
- واحد پول «پایه» یا حسابداری که شرکتتان استفاده میکند.
- نرخ طرح نرخ که جزئیاتی درباره نحوه محاسبه نرخ ارائه میدهد. چون مدل شارژ براساس نرخ ثابت است، فقط یک نرخ طرح نرخ را مشخص میکنید.
در نرخ طرح نرخ، موارد زیر را مشخص میکنید:
- نوع نرخ طرح نرخ (
RATECARD). - نرخ طرح. برای مثال، اگر ۰٫۱۰ را مشخص کنید و واحد پول دلار امریکا باشد، برای هر تراکنش ۰٫۱۰ دلار از توسعهدهنده کسر میشود (یا اگر براساس مشخصه سفارشی مثل تعداد بایتهای منتقلشده در تراکنش باشد، برای انتقال تعداد بایتهای مشخصشده ۰٫۱۰ دلار از توسعهدهنده کسر میشود).
- واحد شروع اعمال نرخ (
0). این یعنی نرخ برای هر تراکنش اعمال میشود، از اولین تراکنش شروع میشود.
برای فهرست کامل گزینههای جزئیات طرح نرخ، تنظیمات پیکربندی جزئیات طرح نرخ را ببینید.
برای مثال، کد زیر طرح کارت نرخ با مدل شارژ ثابت ایجاد میکند. نرخ برای هر تراکنش ۰٫۱۰ دلار تعیین شده است. سررسید پرداخت ۳۰ روز دیگر است. (جزئیات مربوط به کارت نرخ برجسته شده است.)
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Flat rate card plan",
"developer":null,
"developerCategory":null,
"advance": "false",
"currency": {
"id" : "usd"
},
"description": "Flat rate card plan",
"displayName" : "Flat rate card plan",
"frequencyDuration": "30",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"prorate": "false",
"published": "true",
"ratePlanDetails": [
{
"currency": {
"id" : "usd"
},
"paymentDueDays": "30",
"meteringType": "UNIT",
"organization": {
"id": "{org_name}"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.10",
"startUnit": "0"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password
مشخص کردن مدل شارژ دستهبندی براساس حجم
در مدل دستهبندی براساس حجم، جزئیات طرح نرخ را مشخص میکنید که شامل یک یا چند نرخ طرح نرخ است، هر نرخ برای یک «دسته حجم» اعمال میشود، یعنی محدوده حجم تراکنش (یا محدوده براساس یک مشخصه سفارشی مثل تعداد بایتهای منتقلشده). این نوع طرح معمولاً برای تشویق توسعهدهندگان به تولید حجمهای بالاتر با ارائه نرخهای تخفیفدار برای دستههای حجم بالاتر تنظیم میشود.
علاوهبر نرخهای طرح نرخ، موارد زیر را در جزئیات طرح نرخ مشخص میکنید:
- پارامتر ردهبندی که نشان میدهد طرح نرخ براساس تراکنشها
(
VOLUME) یا براساس مشخصه سفارشی (برای نمونه،CUSTOM_ATTRIBUTE_1) است.VOLUMEپیشفرض است. - نوع اندازهگیری (
VOLUME) که نشان میدهد نرخ براساس حجم تراکنشها است (یعنی نرخ ثابت برای هر تراکنش نیست، همانطور که در مدل شارژ نرخ ثابت وجود دارد). - دوره سررسید پرداخت (برای مثال، ۳۰ روز).
- شناسه سازمان شما.
- واحد پول «پایه» یا حسابداری که شرکتتان استفاده میکند.
- مدت و نوع مدت که با هم دوره زمانی را که حجم تراکنشها (یا حجم مربوط به مشخصه سفارشی) در آن تجمیع میشود مشخص میکنند. این مورد همچنین بهعنوان «پایه تجمیع» نامیده میشود. حجم تراکنشها براساس مبنای تجمیع (برای مثال، ۱ ماه) تجمیع میشود تا گروه حجم قابلاعمال تعیین شود.
- شمارندههای تجمیعی که برای تعیین گروه حجم قابلاعمال استفاده میشوند.
برای هر نرخ طرح نرخ، موارد زیر را مشخص میکنید:
- نوع نرخ طرح نرخ (
RATECARD). - نرخ طرح. برای مثال، اگر ۰٫۱۰ را مشخص کنید و واحد پول دلار امریکا باشد، برای هر تراکنش ۰٫۱۵ دلار از توسعهدهنده کسر میشود (یا اگر براساس مشخصه سفارشی مثل تعداد بایتهای منتقلشده در تراکنش باشد، برای انتقال تعداد بایتهای مشخصشده، ۰٫۱۵ دلار از توسعهدهنده کسر میشود).
- واحد شروع و پایان نوار حجم. واحد شروع حد پایین
باند حجم را مشخص میکند و واحد پایان حد بالای باند حجم را مشخص میکند. برای
مثال، اگر واحد شروع را ۰ و واحد پایان را ۱۰۰۰ مشخص کنید، نوار حجم تا
۱۰۰۰ تراکنش را در دوره تجمیع پوشش میدهد. اگر ارز دلار امریکا باشد،
دوره تجمیع ۱ ماه است، و نرخ برای ۱۰۰۰ تراکنش اول ۰٫۱۵ است،
توسعهدهنده برای هر تراکنش تا سقف ۱۰۰۰ تراکنش در ماه ۰٫۱۵ دلار پرداخت میکند.
برای جزئیات مربوط به زمان بازنشانی بستهها، به کارمزدهای تکرارشونده و طرحهای بسته چه زمانی کسر میشوند و بازنشانی میشوند؟ مراجعه کنید.
اگر واحد پایانی برای دسته حجم نهایی مشخص نکنید، نرخ آن دسته برای همه تراکنشها پساز اینکه تعداد تراکنشها از واحد شروع برای آن دسته فراتر رفت اعمال میشود. برای مثال، اگر واحد شروع برای آخرین دسته ۱۰۰۰ باشد و واحد پایان برای آن دسته را مشخص نکنید، نرخ آن دسته برای همه تراکنشهای بعداز ۱۰۰۰ تراکنش در دوره تجمیع اعمال میشود.
برای فهرست کامل گزینههای جزئیات طرح نرخ، تنظیمات پیکربندی جزئیات طرح نرخ را ببینید.
برای مثال، کد زیر طرح کارت نرخ با مدل شارژ دستهبندی براساس حجم ایجاد میکند. نرخ برای ۱۰۰۰ تراکنش اول ۰٫۱۵ دلار و برای همه تراکنشهای بالای ۱۰۰۰ تراکنش ۰٫۱۰ دلار تعیین شده است. مبنای انبوهش ۱ ماه است. سررسید پرداخت ۳۰ روز دیگر است. (جزئیات کارت نرخ برجسته شده است.)
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Volume banded rate card plan",
"developer":null,
"developerCategory":null,
"currency": {
"id" : "usd"
},
"frequencyDuration": "30",
"description": "Volume banded rate card plan",
"displayName" : "Volume banded rate card plan",
"frequencyDuration": "30",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"prorate": "false",
"published": "true",
"ratePlanDetails": [
{
"currency": {
"id" : "usd"
},
"aggregateStandardCounters": true,
"paymentDueDays": "30",
"duration": "1",
"durationType": "MONTH",
"meteringType": "VOLUME",
"organization": {
"id": "{org_name}"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.15",
"startUnit": "0",
"endUnit": "1000"
},
{
"type": "RATECARD",
"rate": "0.10",
"startUnit": "1000"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password
مشخص کردن مدل شارژ دستهای
در مدل شارژ دستهای، توسعهدهنده برای «دستهای» از تراکنشها (یا برای دستهای براساس یک مشخصه سفارشی مثل تعداد بایتهای منتقلشده) (پیشاپیش) پرداخت میکند. نرخی برای هر بسته و پایههای تجمیع مشخص میکنید، یعنی دورهای که توسعهدهنده میتواند از بسته استفاده کند.
برای مثال، فرض کنید دو دسته تنظیم کردهاید که اندازه دسته اول ۱ تا ۱۰۰۰ تراکنش و اندازه دسته دوم ۱۰۰۱ تا ۲۰۰۰ تراکنش است. نرخ برای بسته اول ۵۰ دلار و برای بسته دوم ۴۰ دلار است و مبنای تجمیع ۱ است. اگر توسعهدهنده طرح کارت نرخ را برای بسته اول خریداری کند، برای ۱۰۰۰ تراکنش در یک ماه ۵۰ دلار (پیشپرداخت) میپردازد. توسعهدهنده مبلغ تعیینشده را چه بسته بهطور کامل استفاده شود چه نشود پرداخت میکند. پساز پایان دوره تجمیع، طرح منقضی میشود. اگر توسعهدهنده بخواهد دوباره از بسته استفاده کند، باید طرح (و بسته) را دوباره خریداری کند.
آنچه در جزئیات طرح نرخ مشخص میکنید اساساً همان چیزی است که در جزئیات طرح نرخ برای مدل شارژ براساس حجم مشخص میکنید. تفاوتها به شرح زیر است:
- هر طرح نرخی که مشخص میکنید برای یک بسته است (نه برای یک گروه حجم).
- باید برای آخرین دسته، حد بالایی تعیین کنید، مگر اینکه بخواهید برای تراکنشهای نامحدود در دسته آخر، مبلغ ثابتی از توسعهدهنده دریافت کنید.
برای فهرست کامل گزینههای جزئیات طرح نرخ، تنظیمات پیکربندی جزئیات طرح نرخ را ببینید.
برای مثال، کد زیر طرح کارت نرخ را با مدل شارژ دستهای ایجاد میکند. نرخ برای بسته اول (تا ۱۰۰۰ تراکنش) ۵۰ دلار و برای بسته دوم (بیشتر از ۱۰۰۰ و تا ۲۰۰۰ تراکنش) ۴۰ دلار تعیین شده است. مبنای انبوهش ۱ ماه است. سررسید پرداخت ۳۰ روز دیگر است.
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Bundled rate plan",
"developer":null,
"developerCategory":null,
"currency": {
"id" : "usd"
},
"frequencyDuration": "30",
"description": "Bundled rate plan",
"displayName" : "Bundled rate plan",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"prorate": "true",
"published": "true",
"ratePlanDetails": [
{
"currency": {
"id" : "usd"
},
"aggregateStandardCounters": true,
"paymentDueDays": "30",
"duration": "1",
"durationType": "MONTH",
"meteringType": "STAIR_STEP",
"organization": {
"id": "{org_name}"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "50",
"startUnit": "0",
"endUnit": "1000"
},
{
"type": "RATECARD",
"rate": "40",
"startUnit": "1000",
"endUnit": "2000"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password
مشخص کردن طرح رایگان برای محصولات تکی بااستفاده از API
در طرح کارت نرخ، میتوانید طرحی رایگان برای یک محصول خاص (بهجای بسته API) راهاندازی کنید. طرح «رایگان با امکانات ویژه» به توسعهدهندگان امکان میدهد از محصول API در یک دوره زمانی یا براساس میزان استفاده بهصورت رایگان استفاده کنند.
وقتی طرحی رایگان با ویژگیهای ممتاز برای محصول API تنظیم میکنید، در جزئیات طرح کارت نرخ، دورهای را که توسعهدهنده میتواند از منابع ارائهشده توسط محصول API بدون هزینه استفاده کند مشخص میکنید. این دوره میتواند براساس یکی از موارد زیر باشد:
- مدت، یعنی زمان بین تاریخ مؤثر و تاریخ پایان.
- مقدار، مثل تعداد تراکنشهای مربوط به محصول API یا حجم مربوط به مشخصه سفارشی که در خطمشی ضبط تراکنش ثبت شده است.
اگر دوره رایگان براساس مقدار است، آن را بهصورت تعداد واحدهای رایگان مشخص کنید. برای مثال، کد زیر طرح کارت نرخ با طرح رایگان براساس حجم ۵۰۰۰ واحد ایجاد میکند (مشخصات مربوط به رایگان برجسته شده است).
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Flat rate card plan with freemium period",
"developer":null,
"developerCategory":null,
"advance": "false",
"currency": {
"id" : "usd"
},
"description": "Flat rate card plan with freemium period",
"displayName" : "Flat rate card plan with freemium period",
"frequencyDuration": "30",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "myorg"
},
"paymentDueDays": "30",
"prorate": "false",
"published": "false",
"ratePlanDetails": [
{
"currency": {
"aggregateFreemiumCounters" : true,
"aggregateStandardCounters" : true,
"id" : "usd"
},
"product" : {
"id" : "location",
"displayName":"Location"
},
"paymentDueDays": "30",
"meteringType": "UNIT",
"organization": {
"id": "myorg"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.10",
"startUnit": "0"
}
],
"freemiumUnit": "5000",
"freemiumDuration": "0",
"freemiumDurationType": "DAY",
"ratingParameterUnit":"MB",
"customPaymentTerm": "false",
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password