การย้ายข้อมูลสําหรับนักพัฒนาซอฟต์แวร์ไปยังการสร้างรายได้

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

หากคุณมีนักพัฒนาแอปเดิมที่จำเป็นต้องย้ายข้อมูลไปยังการสร้างรายได้ ให้ทำดังนี้

  1. สร้างผลิตภัณฑ์ API, แพ็กเกจ API และแพ็กเกจราคาสำหรับนักพัฒนาซอฟต์แวร์ที่คุณกำลังจะย้ายข้อมูล หากยังไม่มี ดูข้อมูลเพิ่มเติมได้จากหัวข้อต่อไปนี้
  2. เผยแพร่แพ็กเกจราคาตามที่อธิบายไว้ในการเผยแพร่แพ็กเกจราคา
  3. เพิ่มนักพัฒนาแอปรายใหม่ลงในองค์กร ตามที่อธิบายไว้ในลงทะเบียนนักพัฒนาแอป
  4. เติมยอดคงเหลือแบบชำระเงินล่วงหน้าสำหรับนักพัฒนาแอปแต่ละราย ตามที่อธิบายไว้ในจัดการยอดคงเหลือของบัญชีแบบชำระเงินล่วงหน้า
  5. ยอมรับแพ็กเกจราคาตามที่อธิบายไว้ในซื้อแพ็กเกจราคาโดยใช้ API

    หมายเหตุ: หากต้องการยกเว้นค่าธรรมเนียมการตั้งค่า ให้ตั้งค่าพารามิเตอร์การค้นหา waivefees เป็น true หากมีการเรียกเก็บเงินจากนักพัฒนาแอปแล้ว

  6. หากนักพัฒนาแอปที่คุณย้ายข้อมูลมีธุรกรรมอยู่แล้ว คุณก็โอนการใช้งานธุรกรรมด้วยตนเองได้โดยใช้แหล่งข้อมูลต่อไปนี้
    /organizations/{org_name}/transactions โดยที่ {org_name} คือชื่อองค์กร

    หมายเหตุ: หากนักพัฒนาแอปไม่มีธุรกรรมอยู่ คุณข้ามขั้นตอนนี้ได้

    ทรัพยากร transactions จะแทรกธุรกรรมเดียวที่แสดงถึงการใช้งานธุรกรรมปัจจุบัน และอัปเดตตัวนับภายในทั้งหมดให้แสดงค่าใหม่นี้

    ตัวอย่างเช่น หากนักพัฒนาแอปเรียก API 1,000 ครั้งก่อนการย้ายข้อมูล คุณสามารถตั้งค่าการใช้งานธุรกรรมเป็น 1,000 ได้โดยเรียกใช้แหล่งข้อมูล transactions และตั้งค่าพร็อพเพอร์ตี้ batchSize เป็น 1,000 ในเนื้อหาคำขอเพื่อบันทึกกิจกรรมปัจจุบัน

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

    พร็อพเพอร์ตี้ คำอธิบาย ค่าเริ่มต้น จำเป็นหรือไม่
    application

    รหัสของแอปนักพัฒนาแอป

    		 ไม่มี ใช่
    batchSize

    จํานวนธุรกรรมที่ต้องการโอน

    		 1 ไม่
    custAttn

    ค่าของแอตทริบิวต์ที่กำหนดเองซึ่งใช้กับ batchSize เพื่อคํานวณการใช้งานธุรกรรม

    หมายเลขแอตทริบิวต์ที่กำหนดเองในข้อความต้องระบุเป็นค่าบวกหรือลบ (สูงสุด 4 หลัก) ไม่อนุญาตให้ใช้ค่าติดลบ

    ต้องกำหนดแอตทริบิวต์ที่กำหนดเองในตำแหน่งต่อไปนี้

    		 ไม่มี ใช่
    product

    รหัสของผลิตภัณฑ์ API

    		 ไม่มี ใช่
    type

    ต้องตั้งค่าเป็น CHARGE (ซึ่งเป็นค่าเริ่มต้น)

    		 CHARGE ไม่

    หากต้องการข้ามขั้นตอนการตรวจสอบและบังคับให้ตั้งค่าจำนวนธุรกรรม ให้ตั้งค่าพารามิเตอร์การค้นหา force เป็น true (เช่น ?force=true) โดยค่าเริ่มต้น ระบบจะดำเนินการตาม ?force=false และขั้นตอนการตรวจสอบ ตัวอย่างเช่น หากนักพัฒนาแอปแบบชำระล่วงหน้ามียอดคงเหลือเป็น 0 และกิจกรรมในบัญชีถูกระงับ หาก ?force=false คำขอจะล้มเหลวระหว่างการตรวจสอบ

    ตัวอย่างเช่น คําขอต่อไปนี้จะกําหนดจํานวนธุรกรรมเป็น 50 สําหรับแอปพลิเคชันและผลิตภัณฑ์ 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

    คําขอต่อไปนี้กําหนดการใช้งานธุรกรรมเป็น 12.5 สําหรับแอปพลิเคชันและผลิตภัณฑ์ API ที่ระบุ ในคำขอ ระบบจะตั้งค่า batchSize เป็น 125 และตั้งค่าแอตทริบิวต์ที่กำหนดเองรายการแรกที่กำหนดไว้สำหรับผลิตภัณฑ์ API เป็น 0.1 เมื่อคูณกัน 125 * 0.1 เท่ากับ 12.5

    $ 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 และขั้นตอนการตรวจสอบ ตัวอย่างเช่น หากนักพัฒนาแอปแบบชําระเงินล่วงหน้ามียอดคงเหลือเป็น 0 และกิจกรรมในบัญชีถูกระงับ ?force=falseคําขอจะดำเนินการไม่สำเร็จระหว่างการตรวจสอบ

    ตัวอย่างเช่น คำขอต่อไปนี้เรียกเก็บค่าธรรมเนียมการตั้งค่า 10 ดอลลาร์สหรัฐจากนักพัฒนาแอปที่สมัครใช้บริการแพ็กเกจราคา

    $ 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