انتقال توسعه‌دهندگان به درآمدزایی

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

اگر توسعه‌دهندگان موجودی دارید که باید به «درآمدزایی» منتقل کنید:

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

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

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

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

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

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

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

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

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

    موجود نیست بله
    batchSize

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

    1 نه
    custAttn

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

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

    مشخصه سفارشی باید در موارد زیر تعریف شود:

    موجود نیست بله
    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
    
  7. اگر کارمزد راه‌اندازی یا کارمزدهای تکرارشونده لازم از توسعه‌دهنده کسر نشده است، می‌توانید بااستفاده از منبع زیر، کارمزد راه‌اندازی یا کارمزد تکرارشونده را برای طرح نرخ به‌صورت دستی کسر کنید:
    /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