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

คุณกำลังดูเอกสารประกอบของ 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 เมื่อนำค่าทั้ง 2 มาคูณกัน 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