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

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

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

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

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

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

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

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

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

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

    اموال توضیحات پیش فرض مورد نیاز؟
    application

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

    N/A بله
    batchSize

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

    1 خیر
    custAtt n

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

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

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

    N/A بله
    product

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

    N/A بله
    type

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

    CHARGE خیر

    برای رد شدن از مراحل اعتبارسنجی و تنظیم اجباری تعداد تراکنش ها، پارامتر force query را روی true تنظیم کنید (مثلاً ?force=true ). به طور پیش فرض مراحل ?force=false و اعتبارسنجی اجرا می شود. برای مثال، اگر یک توسعه‌دهنده پیش‌پرداخت موجودی صفر داشته باشد و فعالیت در حساب به حالت تعلیق درآید، اگر ?force=false درخواست در طول اعتبارسنجی ناموفق خواهد بود.

    به عنوان مثال، درخواست زیر تعداد تراکنش ها را برای برنامه و محصول API مشخص شده روی 50 تنظیم می کند:

    $ 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 مشخص شده روی 12.5 تنظیم می کند. در درخواست، batchSize روی 125 و مقدار اولین ویژگی سفارشی تعریف شده برای محصول API روی 0.1 تنظیم شده است. وقتی با هم ضرب شود، 125 * 0.1 می شود 12.5.

    $ 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 برای فرانک سوئیس.

    N/A بله
    developer

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

    N/A بله
    rate

    هزینه راه اندازی یا تکراری برای شارژ.

    N/A بله
    ratePlan

    شناسه طرح نرخ

    N/A بله
    type

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

    CHARGE بله

    برای رد شدن از مراحل اعتبارسنجی و دریافت اجباری هزینه، پارامتر force query را روی true تنظیم کنید (مثلاً ?force=true ). به طور پیش فرض مراحل ?force=false و اعتبارسنجی اجرا می شود. برای مثال، اگر یک توسعه‌دهنده پیش‌پرداخت موجودی صفر داشته باشد و فعالیت در حساب به حالت تعلیق درآید، اگر ?force=false درخواست در طول اعتبارسنجی ناموفق خواهد بود.

    برای مثال، درخواست زیر هزینه راه‌اندازی 10 دلاری را از توسعه‌دهنده‌ای که مشترک طرح نرخ است دریافت می‌کند:

    $ 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