ShareAI Platform Docs

Leia e reduza um plano de uso aceite

Leia o plano de aplicação ShareAI aceito por um cliente e solicite uma redução permitida com verificações de revisão e uma chave de idempotência.

Ver como Markdown
Nesta página

Use a API de acordo de aplicação quando o seu backend precisar ler o plano aceito atual ou aplicar uma redução permitida por esse acordo. Autentique-se como o cliente da aplicação que possui o sujeito do cliente.

GET https://auth.shareai.now/oauth/agreements/{subject}

Leia a concessão aceita e o plano atual.

URL Base
https://auth.shareai.now
Autenticação
HTTP Basic: ID do cliente e segredo do cliente

cURL

curl --fail-with-body "https://auth.shareai.now/oauth/agreements/$SHAREAI_SUBJECT" \
  -u "$SHAREAI_CLIENT_ID:$SHAREAI_CLIENT_SECRET"

A resposta inclui grant_id, revision, plan_id, informações de estado e aceitação. Mantenha a concessão atual e a revisão ao preparar uma alteração.

POST https://auth.shareai.now/oauth/agreements/{subject}

Aplique uma redução permitida dentro do contrato aceito.

URL Base
https://auth.shareai.now
Autenticação
HTTP Basic: ID do cliente e segredo do cliente

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"}'
CampoRegra
subjectUtilize o sujeito opaco da conta deste cliente.
grant_idUse a concessão retornada pela leitura mais recente.
revisionUse a revisão atual; atualize o estado após um conflito.
plan_idEscolha um plano inferior permitido no contrato aceito.
Idempotency-Key16–128 letras, dígitos, sublinhados ou hífens. Reutilize apenas para uma repetição idêntica.

Publicar novos preços não aumenta silenciosamente os acordos existentes com os clientes. Uma taxa mais alta exige consentimento interativo. Uma aplicação não pode usar este endpoint para substituir os termos aceitos do cliente por um contrato mais caro.

Gerencie atualizações simultâneas#

Se a revisão ou concessão tiver mudado, leia o acordo atual e reconsidere a operação. Não incremente a revisão cegamente. Reutilizar uma chave de idempotência para um plano diferente é um erro.

Aprenda o fluxo de trabalho do Console#

Planos de uso e consentimento

Última atualização em 15 de setembro de 2026

Documentação da Plataforma ShareAI
Toda a documentação

Pesquisar por título ou conteúdo.

Perguntar sobre esta página

Escolha um assistente para explorar esta página. Também pode copiar a página e colá-la na sua conversa.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI