Kabul edilen bir kullanım planını okuyun ve düşürün
Bir müşterinin kabul ettiği ShareAI uygulama planını okuyun ve revizyon kontrolleri ve bir idempotans anahtarı ile izin verilen bir azalma talep edin.
Bu sayfada
Arka ucunuzun mevcut kabul edilen planı okuması veya bu anlaşma tarafından izin verilen bir azalmayı uygulaması gerektiğinde uygulama anlaşması API'sini kullanın. Müşterinin konusu üzerinde sahip olan uygulama istemcisi olarak kimlik doğrulaması yapın.
https://auth.shareai.now/oauth/agreements/{subject}Kabul edilen yetkiyi ve mevcut planı okuyun.
- Temel URL
https://auth.shareai.now- Kimlik doğrulama
- HTTP Basic: istemci kimliği ve istemci sırrı
cURL
curl --fail-with-body "https://auth.shareai.now/oauth/agreements/$SHAREAI_SUBJECT" \
-u "$SHAREAI_CLIENT_ID:$SHAREAI_CLIENT_SECRET"
Yanıt şunları içerir grant_id, revision, plan_id, durum ve kabul bilgileri. Bir değişiklik hazırlarken mevcut hibeyi ve revizyonu koruyun.
https://auth.shareai.now/oauth/agreements/{subject}Kabul edilen sözleşme kapsamında izin verilen bir azaltmayı uygulayın.
- Temel URL
https://auth.shareai.now- Kimlik doğrulama
- HTTP Basic: istemci kimliği ve istemci sırrı
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"}'
| Alan | Kural |
|---|---|
subject | Bu istemcinin opak hesap konusunu kullanın. |
grant_id | En son okuma tarafından döndürülen izni kullanın. |
revision | Mevcut revizyonu kullanın; bir çakışmadan sonra durumu yenileyin. |
plan_id | Kabul edilen sözleşmede izin verilen daha düşük bir plan seçin. |
Idempotency-Key | 16–128 harf, rakam, alt çizgi veya tire. Aynı yeniden deneme için tekrar kullanın. |
Daha yüksek bir ücret yeni onay gerektirir#
Yeni fiyatların yayınlanması, mevcut müşteri anlaşmalarını sessizce artırmaz. Daha yüksek bir ücret, etkileşimli onay gerektirir. Bir uygulama, müşterinin kabul ettiği şartları daha pahalı bir sözleşmeyle değiştirmek için bu uç noktayı kullanamaz.
Eşzamanlı güncellemeleri yönetin#
Revizyon veya izin değiştiyse, mevcut anlaşmayı okuyun ve işlemi yeniden değerlendirin. Revizyonu körü körüne artırmayın. Farklı bir plan için yeniden kullanılan bir idempotans anahtarı bir hatadır.
Konsol iş akışını öğrenin#
Son güncelleme Eylül 15, 2026