Читайте и снижайте принятый план использования

Прочитайте утвержденный клиентом план приложения ShareAI и запросите разрешенное уменьшение с проверкой ревизии и ключом идемпотентности.

Просмотреть как Markdown

На этой странице

Используйте API соглашения приложения, когда вашему серверу необходимо прочитать текущий утвержденный план или применить уменьшение, разрешенное этим соглашением. Аутентифицируйтесь как клиент приложения, которому принадлежит субъект клиента.

GET 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, статус и информация о принятии. Сохраните текущий грант и ревизию при подготовке изменений.

POST 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

Более высокая плата требует нового согласия#

Обрабатывайте одновременные обновления#

Узнайте рабочий процесс Консоли#