承認された使用プランを読み取り、引き下げる

顧客が受け入れたShareAIアプリケーションプランを読み取り、改訂チェックと冪等性キーを使用して許可された減少をリクエストします。

このページについて

バックエンドが現在受け入れられているプランを読み取る必要がある場合や、その契約で許可された減少を適用する場合、アプリケーションクライアントとして認証してください。

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文字、数字、アンダースコア、またはハイフン。再試行が同一の場合のみ再利用可能です。

新しい価格を公開しても、既存の顧客契約が自動的に増加することはありません。より高い料金には対話的な同意が必要です。このエンドポイントを使用して、顧客が承認した条件をより高額な契約に置き換えることはできません。

同時更新を処理する#

リビジョンまたは許可が変更された場合、現在の契約を読み取り、操作を再検討してください。リビジョンを無条件に増加させないでください。異なるプランで再利用された冪等性キーはエラーとなります。

コンソールワークフローを学ぶ#

使用プランと同意

最終更新日 2026年9月15日

高い料金には新しい同意が必要#

同時更新を処理する#

コンソールワークフローを学ぶ#