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

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

หากคุณมีนักพัฒนาซอฟต์แวร์อยู่แล้วและต้องการย้ายข้อมูลไปยังการสร้างรายได้:

  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

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

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

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

    ไม่มีข้อมูล ใช่
    product

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

    ไม่มีข้อมูล ใช่
    type

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

    CHARGE ไม่ได้

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

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

    $ 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