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

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

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

توسعه دهنده به حالت تعلیق درآمد

علامت

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

پیام های خطا

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

تشخیص

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

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

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

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

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

2. کد خطا را با کدهای دلایل زیر مقایسه کنید تا بفهمید چرا توسعه دهنده به حالت تعلیق درآمده است.

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

قطعنامه

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

علائم

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

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

پیام های خطا

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

علل احتمالی

اگر هر یک از علائم ذکر شده در Symptoms را مشاهده کردید، به احتمال زیاد تراکنش ها پولی نیستند.

تشخیص علت

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

   مشاهده وضعیت معاملات

2. اگر در مدت زمان مشخص شده هیچ تراکنشی را به عنوان SUCCESS مشاهده نکردید، در این صورت تراکنش ها پولی نمی شوند.

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

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

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

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

تشخیص

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

قطعنامه

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

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

محصول API کسب درآمد نمی شود

تشخیص

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

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

   2. اگر یک کاربر خصوصی Cloud هستید، از 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 یک طرح نرخ فعال دارد.

اگر مشکل ادامه داشت، خط مشی ضبط تراکنش که به درستی تعریف نشده است را بررسی کنید.

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

تشخیص

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. در اینجا یک نمونه ردیابی رابط کاربری وجود دارد که نشان می دهد متغیرهای جریان نعناع به درستی تنظیم شده اند.

   

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

قطعنامه

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

برنامه‌نویس طرح نرخ را خریداری نکرده است

تشخیص

1. از تماس API مدیریت زیر برای تأیید برنامه‌های نرخ خریداری شده توسط توسعه‌دهنده استفاده کنید:
   1. اگر کاربر Public Cloud هستید، از 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 تماس بگیرید.