یک طرح استفاده پذیرفتهشده را بخوانید و کاهش دهید
خواندن طرح برنامه پذیرفتهشده مشتری ShareAI و درخواست کاهش مجاز با بررسیهای بازنگری و کلید idempotency.
در این صفحه
از API توافق برنامه استفاده کنید زمانی که بکاند شما نیاز به خواندن طرح پذیرفتهشده فعلی یا اعمال کاهش مجاز توسط آن توافق دارد. به عنوان مشتری برنامهای که مالک موضوع مشتری است احراز هویت کنید.
https://auth.shareai.now/oauth/agreements/{subject}خواندن مجوز پذیرفتهشده و طرح فعلی.
- URL پایه
https://auth.shareai.now- احراز هویت
- HTTP Basic: شناسه مشتری و راز مشتری
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، اطلاعات وضعیت و پذیرش. هنگام آمادهسازی تغییر، کمکهزینه فعلی و بازبینی را حفظ کنید.
https://auth.shareai.now/oauth/agreements/{subject}کاهش مجاز را در چارچوب قرارداد پذیرفتهشده اعمال کنید.
- URL پایه
https://auth.shareai.now- احراز هویت
- HTTP Basic: شناسه مشتری و راز مشتری
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 | ۱۶–۱۲۸ حرف، رقم، زیرخط یا خط تیره. فقط برای تلاش مجدد یکسان استفاده مجدد کنید. |
هزینه بالاتر نیاز به رضایت جدید دارد#
انتشار قیمتهای جدید بهطور بیصدا توافقهای مشتریان موجود را افزایش نمیدهد. هزینه بالاتر نیاز به رضایت تعاملی دارد. یک برنامه نمیتواند از این نقطه پایانی برای جایگزینی شرایط پذیرفتهشده مشتری با یک قرارداد گرانتر استفاده کند.
مدیریت بهروزرسانیهای همزمان#
اگر نسخه یا مجوز تغییر کرده است، توافق فعلی را بخوانید و عملیات را دوباره بررسی کنید. نسخه را بدون بررسی افزایش ندهید. استفاده مجدد از کلید idempotency برای یک طرح متفاوت یک خطا است.
یادگیری جریان کاری کنسول#
آخرین بهروزرسانی سپتامبر 15, 2026