ShareAI Platform Docs

یک طرح استفاده پذیرفته‌شده را بخوانید و کاهش دهید

خواندن طرح برنامه پذیرفته‌شده مشتری ShareAI و درخواست کاهش مجاز با بررسی‌های بازنگری و کلید idempotency.

مشاهده به‌صورت Markdown
در این صفحه

از API توافق برنامه استفاده کنید زمانی که بک‌اند شما نیاز به خواندن طرح پذیرفته‌شده فعلی یا اعمال کاهش مجاز توسط آن توافق دارد. به عنوان مشتری برنامه‌ای که مالک موضوع مشتری است احراز هویت کنید.

GET 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، اطلاعات وضعیت و پذیرش. هنگام آماده‌سازی تغییر، کمک‌هزینه فعلی و بازبینی را حفظ کنید.

POST 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

مستندات پلتفرم ShareAI
تمام مستندات

جستجو بر اساس عنوان یا محتوا.

درباره این صفحه بپرسید

یک دستیار برای کاوش این صفحه انتخاب کنید. همچنین می‌توانید صفحه را کپی کرده و در مکالمه خود جای‌گذاری کنید.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI