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

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่ เอกสารประกอบของ Apigee X.
info

หัวข้อนี้ให้ข้อมูลและคำแนะนำเกี่ยวกับการแก้ปัญหาการสร้างรายได้ที่พบได้บ่อย

นักพัฒนาแอปถูกระงับ

ลักษณะปัญหา

นักพัฒนาแอปถูกระงับและจะทำธุรกรรมการสร้างรายได้ การเรียก API เพิ่มเติมไม่ได้

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

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

การวินิจฉัย

หากต้องการทราบเหตุผลที่นักพัฒนาแอปถูกระงับ ให้ทำตามขั้นตอนต่อไปนี้

  1. เรียก API ต่อไปนี้เพื่อระบุรหัสข้อผิดพลาดที่เชื่อมโยงกับนักพัฒนาแอปที่ถูกระงับ :
    1. หากคุณเป็นผู้ใช้ Public 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

  1. เรียก 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
      
  2. ใน UI ของ Edge คุณยังตรวจสอบจำนวนการเรียกที่นักพัฒนาแอป ได้รับอนุญาตให้ทำได้โดยเลือก

    แพ็กเกจ > ชื่อแพ็กเกจ > ชื่อแพ็กเกจราคา > ตารางราคา

    ตัวอย่างเช่น หากชื่อแพ็กเกจคือ แพ็กเกจ Pro และเป็น แพ็กเกจฟรี เส้นทางจะเป็นดังนี้

    แพ็กเกจ > แพ็กเกจ Pro > แพ็กเกจฟรี > ตารางราคา

NO_CURRENT_PUBLISHABLE_ENTITY

นักพัฒนาแอปต้องซื้อแพ็กเกจราคาจึงจะเรียก API ได้

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

อาการ

ปัญหาเกี่ยวกับการตั้งค่าการสร้างรายได้อาจแสดงอาการต่างๆ เช่น

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

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

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

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

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

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

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

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

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

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

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

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

การวินิจฉัย

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

ความละเอียด

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

หากยังพบปัญหาอยู่ ให้ตรวจสอบ API Product ไม่ได้รับการสร้างรายได้.

API Product ไม่ได้รับการสร้างรายได้

การวินิจฉัย

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

ความละเอียด

หากต้องการสร้างรายได้จาก API Product ให้ทำตามขั้นตอนต่อไปนี้

  1. กำหนดค่านโยบายการบันทึกธุรกรรม.

  2. ตรวจสอบว่า API Product มีแพ็กเกจราคาที่ใช้งานอยู่

หากยังพบปัญหาอยู่ ให้ตรวจสอบ กำหนดนโยบายการบันทึกธุรกรรมไม่ถูกต้อง

กำหนดนโยบายการบันทึกธุรกรรมไม่ถูกต้อง

การวินิจฉัย

  1. เปิดใช้การติดตาม UI สำหรับพร็อกซี 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. นี่คือตัวอย่างการติดตาม UI ที่แสดงว่าตัวแปรโฟลว์ Mint ได้รับการตั้งค่าอย่างถูกต้อง

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

ความละเอียด

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

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

การวินิจฉัย

  1. ใช้การเรียก Management 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