การแก้ปัญหาเกี่ยวกับการสร้างรายได้

คุณกำลังดูเอกสารประกอบของ 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. หากคุณเป็นผู้ใช้ Private Cloud ให้ใช้ API ต่อไปนี้

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

2. เปรียบเทียบรหัสข้อผิดพลาดกับรหัสเหตุผลต่อไปนี้เพื่อหาสาเหตุที่นักพัฒนาซอฟต์แวร์ถูกระงับ

ดูเพิ่มเติมที่สรุปรหัสเหตุผลสำหรับนักพัฒนาแอปที่ถูกระงับ

รหัสสาเหตุ	สาเหตุ	รายละเอียด
INSUFFICIENT_FUNDS	เงินคงเหลือของบัญชีนักพัฒนาแอปหมดแล้ว	หากเงินคงเหลือของบัญชีนักพัฒนาแอปที่ชำระล่วงหน้ามีเงินไม่เพียงพอสำหรับธุรกรรมเพิ่มเติม นักพัฒนาแอปจะถูกระงับ สำหรับนักพัฒนาซอฟต์แวร์แบบชำระเงินภายหลัง ข้อผิดพลาดนี้อาจเกิดขึ้นหากวงเงินเครดิตเกินขีดจำกัด หรือวงเงินเครดิตที่ตั้งไว้สำหรับสกุลเงินที่ใช้หมด
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED	นักพัฒนาแอปไม่สามารถทำธุรกรรมเพิ่มเติมได้อีก	นักพัฒนาแอปทุกรายได้รับอนุญาตให้ทำธุรกรรมในจำนวนคงที่ตามแพ็กเกจราคาที่ซื้อ หากมีการทำธุรกรรมเกินจำนวนครั้งที่กำหนด นักพัฒนาซอฟต์แวร์จะถูกระงับและทำธุรกรรมเพิ่มเติมให้เสร็จสมบูรณ์ไม่ได้
NO_CURRENT_PUBLISHABLE_ENTITY	นักพัฒนาแอปยังไม่ได้ซื้อแพ็กเกจราคาใดๆ	นักพัฒนาแอปต้องซื้อแพ็กเกจราคาก่อนทำธุรกรรมใดๆ ให้เสร็จสมบูรณ์

ความละเอียด

ข้อผิดพลาด	ขั้นตอนในการแก้ไข
INSUFFICIENT_FUNDS	นักพัฒนาแอปต้องตรวจสอบว่ามียอดคงเหลือในบัญชีหรือเครดิตเพียงพอเพื่อทำธุรกรรมเพิ่มเติมให้เสร็จสมบูรณ์
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED	ทำการเรียก API ต่อไปนี้เพื่อรับรายละเอียดแพ็กเกจราคาสำหรับนักพัฒนาซอฟต์แวร์และรายละเอียดธุรกรรมตามลำดับ เรียกใช้การเรียก API ต่อไปนี้เพื่อรับวันที่เริ่มต้นและวันที่สิ้นสุดของแพ็กเกจราคาที่นักพัฒนาแอปซื้อไว้ http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/developers/%7Bdeveloper_id%7D/developer-accepted-rateplans เรียกใช้การเรียก API ต่อไปนี้เพื่อดูจำนวนธุรกรรมที่ดำเนินการสำเร็จโดยนักพัฒนาแอป http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D คุณยังตรวจสอบจำนวนการโทรที่นักพัฒนาแอปอนุญาตให้ทำได้ใน Edge UI ได้โดยเลือกตัวเลือกต่อไปนี้ Packages > PackageName > RatePlanName > เรตการ์ด เช่น หากชื่อแพ็กเกจคือ แพ็กเกจ Pro และเป็นแพ็กเกจฟรี เส้นทางจะเป็นดังนี้ แพ็กเกจ > แพ็กเกจ Pro > แพ็กเกจฟรี > เรตการ์ด
NO_CURRENT_PUBLISHABLE_ENTITY	นักพัฒนาแอปต้องซื้อแพ็กเกจราคาจึงจะเรียก API ได้

ปัญหาเกี่ยวกับการตั้งค่าการสร้างรายได้

อาการ

ปัญหาการตั้งค่าการสร้างรายได้อาจแสดงให้เห็นลักษณะต่างๆ ดังนี้

• ฟังก์ชันเว็บฮุคไม่ทำงาน
• สร้างเว็บฮุคไม่ได้
• ไม่มีการทริกเกอร์การแจ้งเตือนเว็บฮุค
• รายงานการสร้างรายได้ไม่แสดงธุรกรรมใดๆ ตัวอย่างเช่น ข้อมูล Analytics บ่งชี้ว่านักพัฒนาแอปได้ทำธุรกรรมหลายรายการเสร็จสมบูรณ์ในช่วงระยะเวลาหนึ่งๆ แต่รายงานการสร้างรายได้ไม่แสดงธุรกรรมเหล่านั้นเลย
• ไม่มีการบันทึกข้อมูลธุรกรรม

ข้อความแสดงข้อผิดพลาด

คุณอาจไม่พบข้อความแสดงข้อผิดพลาดใดๆ แต่จะเห็นปัญหาตามที่อธิบายไว้ในส่วนอาการ

สาเหตุที่เป็นไปได้

หากคุณเห็นอาการอย่างใดอย่างหนึ่งที่ระบุไว้ในอาการ แสดงว่าธุรกรรมไม่ได้มีการสร้างรายได้

การวินิจฉัยสาเหตุ

1. ใช้การเรียก Management API ที่อธิบายไว้ในส่วนต่อไปนี้เพื่อตรวจสอบว่าธุรกรรมกำลังสร้างรายได้หรือไม่

   ดูสถานะของธุรกรรม

2. หากคุณไม่เห็นธุรกรรมใดๆ แสดงเป็นสำเร็จภายในระยะเวลาที่ระบุ แสดงว่าธุรกรรมนั้นไม่มีการสร้างรายได้

สาเหตุทั่วไปที่ทำให้ธุรกรรมไม่สร้างรายได้มีดังนี้

• ตรวจสอบขีดจำกัดการสร้างรายได้ของนโยบายที่ไม่ได้แนบกับพร็อกซี API
• APIProduct ไม่สร้างรายได้
• กำหนดนโยบายการบันทึกธุรกรรมไม่ถูกต้อง
• นักพัฒนาแอปยังไม่ได้ซื้อแพ็กเกจราคา

ส่วนต่อไปนี้จะอธิบายวิธีวิเคราะห์และแก้ไขปัญหาแต่ละรายการ

นโยบายการตรวจสอบขีดจำกัดการสร้างรายได้ที่ไม่ได้ใช้ในพร็อกซี API

การวินิจฉัย

1. ตรวจสอบว่าได้แนบนโยบายการตรวจสอบขีดจำกัดการสร้างรายได้ไว้กับพร็อกซี API หรือไม่
2. หากไม่ได้แนบนโยบายไว้ นี่อาจเป็นสาเหตุที่ระบบระบุว่าธุรกรรมล้มเหลวได้

ความละเอียด

แนบนโยบายการตรวจสอบขีดจำกัดการสร้างรายได้กับพร็อกซี API ที่จำเป็นตามที่อธิบายไว้ใน บังคับใช้ขีดจำกัดการสร้างรายได้บนพร็อกซี API

หากยังคงพบปัญหาอยู่ ให้ตรวจสอบ ผลิตภัณฑ์ API ไม่มีการสร้างรายได้

ไม่มีการสร้างรายได้สำหรับผลิตภัณฑ์ API

การวินิจฉัย

1. ตรวจสอบว่าผลิตภัณฑ์ API มีการสร้างรายได้หรือไม่ (เฉพาะผลิตภัณฑ์ API ที่สร้างรายได้จะได้รับการจัดประเภทและจะแสดงอยู่ในธุรกรรม) ผลิตภัณฑ์ที่สร้างรายได้คือผลิตภัณฑ์ที่มีแพ็กเกจราคาที่ใช้งานอยู่อย่างน้อย 1 แพ็กเกจ
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. หากคุณเป็นผู้ใช้ Private 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. เปิดใช้การติดตาม UI สำหรับพร็อกซี API ที่มีนโยบายการตรวจสอบขีดจำกัดการสร้างรายได้แนบอยู่
2. เลือกคำขอ API ที่ต้องการจากการติดตาม UI
3. เลือกขั้นตอน AX ของ Analytics แล้วตรวจสอบว่าตัวแปรขั้นตอนการสร้างรายได้ (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. ต่อไปนี้เป็นตัวอย่างการติดตาม UI ที่แสดงให้เห็นว่าตัวแปรโฟลว์ของ Mint ได้รับการตั้งค่าอย่างถูกต้อง

   

5. หากพบข้อผิดพลาดในตัวแปร mint.tx.status แสดงว่ามีการกำหนดนโยบายการบันทึกธุรกรรมอย่างไม่ถูกต้อง

ความละเอียด

1. ตรวจสอบว่าได้ทำตามขั้นตอนทั้งหมดที่บันทึกไว้ใน สร้างนโยบายการบันทึกธุรกรรมอย่างถูกต้องขณะสร้างนโยบายการบันทึกธุรกรรม
2. ค่าคีย์คือ "เกณฑ์ความสำเร็จของธุรกรรม" ที่กำหนดไว้ในนโยบายการบันทึกธุรกรรม ดู ตัวอย่างการกำหนดเกณฑ์ความสำเร็จของธุรกรรมในนโยบายการบันทึกธุรกรรม

นักพัฒนาแอปยังไม่ได้ซื้อแพ็กเกจราคา

การวินิจฉัย

1. ใช้การเรียก API การจัดการต่อไปนี้เพื่อยืนยันแพ็กเกจอัตราที่นักพัฒนาแอปซื้อ
   1. หากคุณเป็นผู้ใช้ Cloud 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