อ่านและลดแผนการใช้งานที่ได้รับการยอมรับ

อ่านแผนการใช้งานแอปพลิเคชัน ShareAI ที่ลูกค้ายอมรับและขอลดลงที่ได้รับอนุญาตพร้อมการตรวจสอบการแก้ไขและคีย์ idempotency.

ในหน้านี้

ใช้ API ข้อตกลงแอปพลิเคชันเมื่อแบ็กเอนด์ของคุณต้องการอ่านแผนที่ได้รับการยอมรับในปัจจุบันหรือใช้การลดลงที่ได้รับอนุญาตตามข้อตกลงนั้น รับรองความถูกต้องในฐานะไคลเอนต์แอปพลิเคชันที่เป็นเจ้าของหัวข้อของลูกค้า.

GET https://auth.shareai.now/oauth/agreements/{subject}

อ่านการอนุญาตที่ได้รับและแผนปัจจุบัน.

Base URL → URL พื้นฐาน: https://auth.shareai.now
การตรวจสอบสิทธิ์: HTTP Basic: ID ลูกค้าและความลับของลูกค้า

cURL

curl --fail-with-body "https://auth.shareai.now/oauth/agreements/$SHAREAI_SUBJECT" \
  -u "$SHAREAI_CLIENT_ID:$SHAREAI_CLIENT_SECRET"

การตอบกลับประกอบด้วย grant_id, revision, plan_id, สถานะและข้อมูลการยอมรับ เก็บรักษาสิทธิ์ที่ได้รับและการแก้ไขปัจจุบันเมื่อเตรียมการเปลี่ยนแปลง.

POST https://auth.shareai.now/oauth/agreements/{subject}

ใช้การลดที่ได้รับอนุญาตภายในสัญญาที่ได้รับการยอมรับ.

Base URL → URL พื้นฐาน: https://auth.shareai.now
การตรวจสอบสิทธิ์: HTTP Basic: ID ลูกค้าและความลับของลูกค้า

cURL

curl --fail-with-body "https://auth.shareai.now/oauth/agreements/$SHAREAI_SUBJECT" \
  -u "$SHAREAI_CLIENT_ID:$SHAREAI_CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $UNIQUE_CHANGE_KEY" \
  --data '{"grant_id":"CURRENT_GRANT_ID","revision":1,"plan_id":"growth"}'

ฟิลด์	กฎ
`subject`	ใช้หัวข้อบัญชีที่ไม่โปร่งใสของลูกค้ารายนี้.
`grant_id`	ใช้สิทธิ์ที่ส่งคืนจากการอ่านล่าสุด.
`revision`	ใช้การแก้ไขปัจจุบัน; รีเฟรชสถานะหลังจากเกิดความขัดแย้ง.
`plan_id`	เลือกแผนที่ต่ำกว่าในสัญญาที่ได้รับการยอมรับ.
`Idempotency-Key`	16–128 ตัวอักษร, ตัวเลข, ขีดล่าง หรือขีดกลาง ใช้ซ้ำได้เฉพาะสำหรับการลองใหม่ที่เหมือนกัน.

การเผยแพร่ราคาที่ใหม่ไม่ได้เพิ่มข้อตกลงลูกค้าเดิมโดยอัตโนมัติ ค่าธรรมเนียมที่สูงขึ้นต้องการการยินยอมแบบโต้ตอบ แอปพลิเคชันไม่สามารถใช้จุดสิ้นสุดนี้เพื่อแทนที่เงื่อนไขที่ลูกค้ายอมรับด้วยสัญญาที่แพงกว่า.

จัดการการอัปเดตพร้อมกัน#

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

เรียนรู้เวิร์กโฟลว์ของ Console#

แผนการใช้งานและการยินยอม

อัปเดตล่าสุด กันยายน 15, 2026

ค่าธรรมเนียมที่สูงขึ้นต้องการความยินยอมใหม่#

จัดการการอัปเดตพร้อมกัน#

เรียนรู้เวิร์กโฟลว์ของ Console#