درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
اگر توسعهدهندگان موجودی دارید که باید به «درآمدزایی» منتقل کنید:
- محصولات API، بستههای API، و طرحهای نرخ را برای توسعهدهندگانی که درحال انتقال هستند ایجاد کنید، اگر ازقبل وجود ندارند. برای کسب اطلاعات بیشتر، این موارد را ببینید:
- طرحهای نرخ را همانطور که در انتشار طرحهای نرخ توضیح داده شده است منتشر کنید.
- توسعهدهندگان جدید را به سازمانتان اضافه کنید، همانطور که در ثبت توسعهدهندگان برنامه توضیح داده شده است.
- موجودی پیشپرداخت را برای هر توسعهدهنده، همانطور که در مدیریت موجودیهای حساب پیشپرداخت توضیح داده شده است، افزایش دهید.
- طرح نرخ را، همانطور که در خرید طرحهای نرخ بااستفاده از API توضیح داده شده است، بپذیرید.
توجه: برای صرفنظر کردن از کارمزدهای راهاندازی، اگر توسعهدهندهای قبلاً هزینه را پرداخت کرده است، پارامتر پُرسمان
waivefeesرا رویtrueتنظیم کنید. - اگر توسعهدهندهای که درحال انتقال آن هستید تراکنشهای موجود دارد،
میتوانید بااستفاده از منبع زیر، استفاده از تراکنش را بهصورت دستی منتقل کنید:
/organizations/{org_name}/transactions، که در آن{org_name}نام سازمان است.توجه: اگر توسعهدهنده تراکنشهای موجود ندارد، میتوانید از این مرحله رد شوید.
منبع
transactionsیک تراکنش واحد را درج میکند که نشاندهنده استفاده از تراکنش کنونی است و همه شمارندههای داخلی را بهروز میکند تا این مقدار جدید را منعکس کند.برای مثال، اگر توسعهدهنده قبلاز انتقال ۱۰۰۰ تماس با API برقرار کرده است، برای ثبت فعالیت کنونی میتوانید با فراخوانی منبع
transactionsو تنظیم داراییbatchSizeروی ۱۰۰۰ در بدنه درخواست، مصرف تراکنش را روی ۱۰۰۰ تنظیم کنید.جدول زیر خلاصه ویژگیهای پیکربندی است که میتوانید در بدنه درخواست مشخص کنید تا تعداد تراکنشها، مقادیر پیشفرض آنها، و اینکه آیا الزامی هستند یا نه را بهصورت دستی تنظیم کنید.
دارایی شرح پیشفرض الزامی است؟ applicationشناسه برنامه توسعهدهنده.
موجود نیست بله batchSizeتعداد تراکنشهایی که میخواهید انتقال دهید.
1 نه custAttnمقدار مشخصه سفارشی که با batchSize برای محاسبه استفاده از تراکنش استفاده میشود.
تعداد مشخصه سفارشی در پیام باید بهعنوان عدد صحیح مثبت یا مقدار اعشاری (تا چهار رقم اعشار) مشخص شود. مقادیر منفی مجاز نیست.
مشخصه سفارشی باید در موارد زیر تعریف شود:
- خطمشی ضبط تراکنش برای محصول API. پیکربندی خطمشی ضبط تراکنش را ببینید.
- طرح نرخ فعال برای محصول API. پیکربندی طرح نرخ با مشخصههای سفارشی را ببینید.
موجود نیست بله productشناسه محصول API.
موجود نیست بله typeباید روی
CHARGE(که پیشفرض است) تنظیم شود.CHARGEنه برای رد شدن از مراحل اعتبارسنجی و تنظیم اجباری تعداد تراکنشها، پارامتر پُرسمان
forceرا رویtrueتنظیم کنید (برای نمونه،?force=true). بهطور پیشفرض،?force=falseو مراحل اعتبارسنجی اجرا میشوند. برای مثال، اگر توسعهدهنده پیشپرداخت موجودی صفر داشته باشد و فعالیت حساب تعلیق شده باشد، اگر?force=falseدرخواست درطول اعتبارسنجی ناموفق خواهد بود.برای مثال، درخواست زیر تعداد تراکنشها را برای برنامه و محصول API مشخصشده روی ۵۰ تنظیم میکند:
$ curl -H "Content-Type:application/json" -X POST -d \ '{ "application":{ "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b" }, "product":{ "id":"testproduct" }, "batchSize":50 }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \ -u email:passwordدرخواست زیر استفاده از تراکنش را برای برنامه و محصول «میانای برنامهسازی کاربردی» مشخصشده روی ۱۲٫۵ تنظیم میکند. در درخواست،
batchSizeروی125تنظیم شده است و مقدار برای اولین مشخصه سفارشی تعریفشده برای محصول API روی0.1تنظیم شده است. وقتی در هم ضرب شوند، ۱۲۵ * ۰٫۱ برابر با ۱۲٫۵ است.$ curl -H "Content-Type:application/json" -X POST -d \ '{ "application":{ "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b" }, "product":{ "id":"testproduct" }, "batchSize": 125, "custAtt1" : 0.1 }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \ -u email:password - اگر کارمزد راهاندازی یا کارمزدهای تکرارشونده لازم از توسعهدهنده کسر نشده است، میتوانید بااستفاده از منبع زیر، کارمزد راهاندازی یا کارمزد تکرارشونده را برای طرح نرخ بهصورت دستی کسر کنید:
/organizations/{org_name}/transactions، که در آن{org_name}نام سازمان است.توجه: اگر قبلاً از توسعهدهنده کارمزد راهاندازی یا تکرارشونده کسر شده است، میتوانید از این مرحله رد شوید. تماس با منبع
transactionsبر راهاندازی یا کارمزدهای تکرارشونده تعریفشده توسط طرح نرخ تأثیری نخواهد داشت.جدول زیر ویژگیهای پیکربندی را که میتوانید در بدنه درخواست برای کسر دستی کارمزد راهاندازی یا تکرارشونده برای طرح نرخ مشخص کنید، مقادیر پیشفرض آنها، و اینکه الزامی هستند یا نه خلاصه میکند.
دارایی شرح پیشفرض الزامی است؟ currencyارز استفادهشده برای طرح نرخ. کد ISO 4217 را برای واحد پول مشخص کنید، مثلاً usd برای دلار ایالات متحده یا chf برای فرانک سوئیس.
موجود نیست بله developerشناسه توسعهدهنده.
موجود نیست بله rateکارمزد راهاندازی یا تکرارشونده برای کسر.
موجود نیست بله ratePlanشناسه طرح نرخ.
موجود نیست بله typeروی
SETUPFEESیاRECURRINGFEESتنظیم کنید.CHARGEبله برای رد کردن مراحل اعتبارسنجی و کسر اجباری کارمزد، پارامتر پُرسمان
forceرا رویtrueتنظیم کنید (برای مثال،?force=true). بهطور پیشفرض،?force=falseو مراحل اعتبارسنجی اجرا میشوند. برای مثال، اگر توسعهدهنده پیشپرداخت موجودی صفر داشته باشد و فعالیت حساب تعلیق شده باشد، اگر?force=falseدرخواست درطول اعتبارسنجی ناموفق خواهد بود.برای مثال، درخواست زیر کارمزد راهاندازی ۱۰ دلار امریکا را از توسعهدهندهای که در طرح نرخ مشترک شده است کسر میکند:
$ curl -H "Content-Type:application/json" -X POST -d \ '{ "developer":{ "id":"dev1@myorg.com" }, "currency":{ "id":"usd" }, "ratePlan":{ "id":"mypackage_rateplan1" }, "rate":10, "type":"SETUPFEES" }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \ -u email:password