读取并降低已接受的使用计划
阅读客户接受的 ShareAI 应用计划，并通过修订检查和幂等键请求允许的减少。
本页面内容
当您的后端需要读取当前接受的计划或应用协议允许的减少时，请使用应用协议 API。以拥有客户主体的应用客户端身份进行认证。
GET
https://auth.shareai.now/oauth/agreements/{subject}阅读已接受的授权和当前计划。
- 基础 URL
https://auth.shareai.now- 身份验证
- HTTP Basic：客户端 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 Basic：客户端 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个字母、数字、下划线或连字符。仅在完全相同的重试中重复使用。 |
更高费用需要新的同意#
发布新价格不会默默提高现有客户协议。更高费用需要交互式同意。应用程序不能使用此端点将客户已接受的条款替换为更昂贵的合同。
处理并发更新#
如果修订版本或授权发生变化，请读取当前协议并重新考虑操作。不要盲目递增修订版本。为不同计划重复使用幂等密钥是错误的。
了解控制台工作流程#
最近更新于 9 月 15, 2026