閱讀同降低已接受嘅使用計劃
閱讀客戶接受嘅ShareAI應用計劃，並使用修訂檢查同冪等鍵請求允許嘅減少。
喺呢頁面
當你嘅後端需要閱讀當前接受嘅計劃或應用該協議允許嘅減少時，使用應用協議API。以擁有客戶主體嘅應用程序客戶端身份進行身份驗證。
GET
https://auth.shareai.now/oauth/agreements/{subject}閱讀接受嘅授權同當前計劃。
- 基礎 URL
https://auth.shareai.now- 認證
- HTTP基本：客戶端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}喺接受嘅合約內申請允許嘅減少。
- 基礎 URL
https://auth.shareai.now- 認證
- HTTP基本：客戶端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 個字母、數字、底線或者連字符。只喺相同重試情況下重用。 |
更高嘅費用需要新嘅同意#
發佈新價格唔會默認增加現有客戶協議。更高費用需要互動式同意。應用程式唔可以用呢個端點嚟用更貴嘅合約取代客戶接受嘅條款。
處理並發更新#
如果修訂版本或者授權有變，請讀取當前協議並重新考慮操作。唔好盲目增加修訂版本。重用唔同計劃嘅冪等鍵係錯誤。
學習控制台工作流程#
最後更新日期：2026年9月15日