قراءة خطة الاستخدام المقبولة وخفضها
قراءة خطة تطبيق ShareAI المقبولة من العميل وطلب تخفيض مسموح به مع فحوصات المراجعة ومفتاح عدم التكرار.
في هذه الصفحة
استخدم واجهة برمجة تطبيقات اتفاقية التطبيق عندما يحتاج الخلفية الخاصة بك إلى قراءة الخطة المقبولة الحالية أو تطبيق تخفيض مسموح به بموجب تلك الاتفاقية. قم بالمصادقة كعميل التطبيق الذي يمتلك موضوع العميل.
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 | 16–128 حرفًا، أرقام، شرطات سفلية أو شرطات. أعد الاستخدام فقط لإعادة المحاولة المطابقة. |
تحتاج الرسوم الأعلى إلى موافقة جديدة#
نشر أسعار جديدة لا يزيد بصمت من اتفاقيات العملاء الحالية. الرسوم الأعلى تتطلب موافقة تفاعلية. لا يمكن للتطبيق استخدام هذه النقطة النهائية لاستبدال شروط العميل المقبولة بعقد أكثر تكلفة.
التعامل مع التحديثات المتزامنة#
إذا تغير الإصدار أو المنحة، اقرأ الاتفاقية الحالية وأعد النظر في العملية. لا تقم بزيادة الإصدار بشكل أعمى. إعادة استخدام مفتاح التكرار لخطة مختلفة يعتبر خطأ.
تعلم سير عمل وحدة التحكم#
آخر تحديث سبتمبر 15, 2026