مهاجرت توسعه دهندگان به کسب درآمد

شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات

اگر توسعه‌دهندگان فعلی دارید که باید به کسب درآمد مهاجرت کنید:

  1. اگر توسعه‌دهندگانی که قصد مهاجرت به آن‌ها را دارید، از قبل وجود ندارند، محصولات API، بسته‌های API و طرح‌های نرخ‌گذاری را برای آن‌ها ایجاد کنید. برای اطلاعات بیشتر، به موارد زیر مراجعه کنید:
  2. طرح‌های نرخ را همانطور که در «انتشار طرح‌های نرخ» توضیح داده شده است، منتشر کنید.
  3. همانطور که در بخش «ثبت توسعه‌دهندگان برنامه» توضیح داده شده است، توسعه‌دهندگان جدید را به سازمان خود اضافه کنید.
  4. موجودی پیش‌پرداخت هر توسعه‌دهنده را، همانطور که در مدیریت موجودی حساب‌های پیش‌پرداخت توضیح داده شده است، افزایش دهید.
  5. طرح نرخ را همانطور که در «طرح‌های نرخ خرید با استفاده از API» توضیح داده شده است، بپذیرید.

    توجه : برای چشم‌پوشی از هزینه‌های راه‌اندازی، اگر از توسعه‌دهنده قبلاً هزینه‌ای دریافت شده است، پارامتر query waivefees را روی true تنظیم کنید.

  6. اگر توسعه‌دهنده‌ای که در حال انتقال او هستید، تراکنش‌های موجود را دارد، می‌توانید با استفاده از منبع زیر، میزان استفاده از تراکنش‌ها را به صورت دستی منتقل کنید:
    /organizations/{org_name}/transactions ، که در آن {org_name} نام سازمان است.

    توجه: اگر توسعه‌دهنده تراکنش‌های موجود را ندارد، می‌توانید از این مرحله صرف نظر کنید.

    منبع transactions یک تراکنش واحد را درج می‌کند که میزان استفاده از تراکنش فعلی را نشان می‌دهد و تمام شمارنده‌های داخلی را برای انعکاس این مقدار جدید به‌روزرسانی می‌کند.

    برای مثال، اگر توسعه‌دهنده قبل از مهاجرت، ۱۰۰۰ فراخوانی به API انجام داده باشد، برای ثبت فعالیت فعلی می‌توانید با فراخوانی منبع transactions و تنظیم ویژگی batchSize روی ۱۰۰۰ در بدنه درخواست، میزان استفاده از تراکنش را روی ۱۰۰۰ تنظیم کنید.

    جدول زیر خلاصه‌ای از ویژگی‌های پیکربندی را که می‌توانید در بدنه درخواست مشخص کنید تا تعداد تراکنش‌ها، مقادیر پیش‌فرض آنها و اینکه آیا الزامی هستند یا خیر را به صورت دستی تنظیم کنید، نشان می‌دهد.

    ملک توضیحات پیش‌فرض الزامی است؟
    application

    شناسه برنامه توسعه‌دهنده.

    		 ناموجود بله
    batchSize

    تعداد تراکنش‌هایی که می‌خواهید منتقل کنید.

    		 ۱ خیر
    custAtt n

    مقدار ویژگی سفارشی که با batchSize برای محاسبه میزان استفاده از تراکنش استفاده می‌شود.

    شماره ویژگی سفارشی در پیام باید به صورت یک مقدار صحیح مثبت یا اعشاری (تا چهار رقم اعشار) مشخص شود. مقادیر منفی مجاز نیستند.

    ویژگی سفارشی باید در موارد زیر تعریف شود:

    		 ناموجود بله
    product

    شناسه محصول API.

    		 ناموجود بله
    type

    باید روی CHARGE تنظیم شود (که پیش‌فرض است).

    		 CHARGE خیر

    برای رد کردن مراحل اعتبارسنجی و تنظیم اجباری تعداد تراکنش‌ها، پارامتر force query را روی 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

    درخواست زیر میزان استفاده از تراکنش را برای برنامه و محصول API مشخص شده روی ۱۲.۵ تنظیم می‌کند. در درخواست، 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
  7. اگر هزینه‌های راه‌اندازی یا دوره‌ای لازم از توسعه‌دهنده دریافت نشده باشد، می‌توانید با استفاده از منبع زیر، هزینه راه‌اندازی یا دوره‌ای را برای یک طرح تعرفه‌ای به صورت دستی دریافت کنید:
    /organizations/{org_name}/transactions ، که در آن {org_name} نام سازمان است.

    توجه: اگر از توسعه‌دهنده قبلاً هزینه‌های راه‌اندازی یا دوره‌ای دریافت شده است، می‌توانید از این مرحله صرف نظر کنید. فراخوانی منبع transactions تاثیری بر هزینه‌های راه‌اندازی یا دوره‌ای تعریف‌شده توسط طرح نرخ نخواهد داشت.

    جدول زیر ویژگی‌های پیکربندی که می‌توانید در بدنه درخواست برای دریافت دستی هزینه راه‌اندازی یا دوره‌ای برای یک طرح تعرفه مشخص کنید، مقادیر پیش‌فرض آنها و اینکه آیا الزامی هستند یا خیر را خلاصه می‌کند.

    ملک توضیحات پیش‌فرض الزامی است؟
    currency

    ارز مورد استفاده برای طرح نرخ. کد ISO 4217 را برای ارز مشخص کنید، مانند usd برای دلار ایالات متحده یا chf برای فرانک سوئیس.

    		 ناموجود بله
    developer

    شناسه توسعه‌دهنده.

    		 ناموجود بله
    rate

    هزینه تنظیم یا دوره‌ای برای دریافت.

    		 ناموجود بله
    ratePlan

    شناسه طرح تعرفه.

    		 ناموجود بله
    type

    روی SETUPFEES یا RECURRINGFEES تنظیم کنید.

    		 CHARGE بله

    برای رد کردن مراحل اعتبارسنجی و دریافت اجباری کارمزد، پارامتر force query را روی 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