عیب یابی مشکلات کسب درآمد

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

این مبحث اطلاعات و راهنمایی‌هایی در مورد عیب‌یابی مشکلات رایج کسب درآمد ارائه می‌دهد.

توسعه‌دهنده معلق شد

علامت

توسعه‌دهنده به حالت تعلیق درآمده و قادر به انجام هیچ تراکنش کسب درآمد/فراخوانی API اضافی نخواهد بود.

پیام‌های خطا

<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>

تشخیص

برای تعیین دلیل تعلیق توسعه‌دهنده، مراحل زیر را انجام دهید:

1. برای شناسایی کد خطای مرتبط با توسعه‌دهنده‌ی معلق‌شده، فراخوانی API زیر را اجرا کنید:
   1. اگر کاربر فضای ابری عمومی هستید، از API زیر استفاده کنید:

      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password

   2. اگر کاربر فضای ابری خصوصی هستید، از API زیر استفاده کنید:

      curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password

2. کد خطا را با کدهای دلیل زیر مقایسه کنید تا دلیل تعلیق توسعه‌دهنده مشخص شود.

همچنین ببینید: خلاصه کدهای دلیل برای توسعه‌دهندگان معلق شده

وضوح تصویر

مشکلات راه‌اندازی کسب درآمد

علائم

مشکلات مربوط به راه‌اندازی کسب درآمد می‌تواند به صورت علائم مختلفی مانند موارد زیر بروز کند:

• قابلیت وب هوک کار نمی‌کند
• نمی‌توان وب‌هوک ایجاد کرد
• اعلان‌های وب‌هوک فعال نمی‌شوند
• گزارش‌های کسب درآمد هیچ تراکنشی را نشان نمی‌دهند. به عنوان مثال، داده‌های Analytics نشان می‌دهد که توسعه‌دهنده در یک دوره زمانی خاص تراکنش‌های زیادی را انجام داده است، اما گزارش‌های کسب درآمد هیچ یک از این تراکنش‌ها را فهرست نمی‌کنند.
• تراکنش‌ها ثبت نمی‌شوند

پیام‌های خطا

ممکن است هیچ پیام خطایی مشاهده نکنید، اما مشکلاتی را که در بخش علائم توضیح داده شده است، مشاهده خواهید کرد.

علل احتمالی

اگر هر یک از علائم ذکر شده در بخش «علائم» را مشاهده می‌کنید، به احتمال زیاد تراکنش‌ها به پول تبدیل نمی‌شوند.

تشخیص علت

1. برای بررسی اینکه آیا تراکنش‌ها در حال کسب درآمد هستند یا خیر، از فراخوانی API مدیریت که در بخش بعدی توضیح داده شده است، استفاده کنید.

   مشاهده وضعیت تراکنش‌ها

2. اگر در مدت زمان مشخص شده هیچ تراکنشی به عنوان موفقیت‌آمیز (SUCCESS) ثبت نشد، آنگاه تراکنش‌ها درآمدزا نیستند.

دلایل معمول برای عدم کسب درآمد از تراکنش‌ها عبارتند از:

• محدودیت‌های کسب درآمد، سیاست بررسی به پروکسی API پیوست نشده است
• APIProduct درآمدزا نیست
• سیاست ثبت تراکنش به اشتباه تعریف شده است
• توسعه‌دهنده طرح تعرفه‌ای را خریداری نکرده است

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

سیاست بررسی محدودیت‌های کسب درآمد در پروکسی API استفاده نمی‌شود

تشخیص

1. بررسی کنید که آیا سیاست بررسی محدودیت‌های کسب درآمد به پروکسی‌های API پیوست شده است یا خیر.
2. اگر این پالیسی پیوست نشده باشد، می‌تواند دلیل نمایش تراکنش‌ها به عنوان ناموفق (FAILED) باشد.

وضوح تصویر

سیاست بررسی محدودیت‌های کسب درآمد را به پروکسی‌های API مورد نیاز، همانطور که در «اعمال محدودیت‌های کسب درآمد روی پروکسی‌های API» توضیح داده شده است، پیوست کنید.

اگر مشکل همچنان ادامه داشت، بررسی کنید که آیا محصول API پولی شده است یا خیر .

محصول API درآمدزا نیست

تشخیص

1. بررسی کنید که آیا محصول API پولی است یا خیر (فقط محصولات API پولی رتبه‌بندی می‌شوند و در بخش تراکنش‌ها فهرست می‌شوند). محصول پولی، محصولی است که حداقل یک طرح نرخ فعال در دسترس داشته باشد.
2. برای دریافت لیست محصولات API پولی، از فراخوانی API مدیریتی زیر استفاده کنید:
   1. اگر کاربر فضای ابری عمومی هستید، از API زیر استفاده کنید:

      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password

   2. اگر کاربر فضای ابری خصوصی هستید، از API زیر استفاده کنید:

      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password

3. اگر محصول API مرتبط با پروکسی API شما قابل کسب درآمد نیست، این می‌تواند دلیل عدم کسب درآمد از تراکنش‌ها باشد.

وضوح تصویر

برای کسب درآمد از یک محصول API، مراحل زیر را انجام دهید:

1. سیاست ثبت تراکنش را پیکربندی کنید .

2. بررسی کنید که محصول API دارای طرح نرخ فعال باشد.

اگر مشکل همچنان ادامه داشت، گزینه‌ی «Transaction recording policy incorrectly defined» را بررسی کنید.

سیاست ثبت تراکنش به اشتباه تعریف شده است

تشخیص

1. ردیابی رابط کاربری را برای پروکسی API که سیاست بررسی محدودیت‌های کسب درآمد به آن پیوست شده است، فعال کنید.
2. یک درخواست API خاص را از مسیر UI انتخاب کنید.
3. جریان Analytics AX را انتخاب کنید و بررسی کنید که آیا متغیرهای جریان کسب درآمد (mint) زیر مقادیر مناسبی دارند یا خیر:

   mint.tx.status - Should match the value set up for "success criteria" in the transaction recording policy for the API product being used. When tracing, the txProviderStatus in the transaction recording policy is stored in the variable 'mint.tx.status'.
   mint.tx.app_id - Application id of API product.
   mint.tx.prod_id - API product id.

4. در اینجا یک نمونه از رابط کاربری را مشاهده می‌کنید که نشان می‌دهد متغیرهای جریان mint به درستی تنظیم شده‌اند.

   

5. اگر در متغیر mint.tx.status خطایی مشاهده کردید، نشان می‌دهد که سیاست ثبت تراکنش به اشتباه تعریف شده است.

وضوح تصویر

1. اطمینان حاصل کنید که تمام مراحل مستند شده در «ایجاد سیاست ثبت تراکنش» هنگام ایجاد سیاست ثبت تراکنش به درستی دنبال شده‌اند.
2. مقدار کلیدی، «معیارهای موفقیت تراکنش» است که در سیاست ثبت تراکنش تعیین شده است. به نمونه‌هایی از تنظیم معیارهای موفقیت تراکنش در یک سیاست ثبت تراکنش مراجعه کنید.

توسعه‌دهنده طرح تعرفه‌ای را خریداری نکرده است

تشخیص

1. برای تأیید برنامه‌های نرخ خریداری شده توسط توسعه‌دهنده، از فراخوانی API مدیریتی زیر استفاده کنید:
   1. اگر کاربر فضای ابری عمومی هستید، از API زیر استفاده کنید:

      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password

   2. اگر کاربر Private Cloud هستید، از API زیر استفاده کنید:

      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password

2. بر اساس پاسخ تماس فوق، طرحی را که در زمان تکمیل تراکنش توسط توسعه‌دهنده فعال بوده است، پیدا کنید.

وضوح تصویر

توسعه‌دهنده باید طرح نرخ را بر اساس نیازهای خود خریداری کند و سپس تراکنش‌ها/APIها را اجرا کند.

اگر مشکل همچنان ادامه داشت، با پشتیبانی Apigee Edge تماس بگیرید.