ShareAI Platform Docs

Lee y reduce un plan de uso aceptado

Lee el plan de aplicación de ShareAI aceptado por un cliente y solicita una disminución permitida con verificaciones de revisión y una clave de idempotencia.

Ver como Markdown
En esta página

Usa la API de acuerdos de aplicación cuando tu backend necesite leer el plan aceptado actual o aplicar una disminución permitida por ese acuerdo. Autentícate como el cliente de la aplicación que posee el sujeto del cliente.

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

Lee la concesión aceptada y el plan actual.

URL base
https://auth.shareai.now
Autenticación
HTTP Basic: ID de cliente y secreto de cliente

cURL

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

La respuesta incluye grant_id, revision, plan_id, información de estado y aceptación. Mantén la concesión actual y la revisión al preparar un cambio.

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

Aplica una disminución permitida dentro del contrato aceptado.

URL base
https://auth.shareai.now
Autenticación
HTTP Basic: ID de cliente y secreto de 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"}'
CampoRegla
subjectUsa el sujeto opaco de la cuenta de este cliente.
grant_idUsa la concesión devuelta por la última lectura.
revisionUsa la revisión actual; actualiza el estado después de un conflicto.
plan_idElige un plan inferior permitido en el contrato aceptado.
Idempotency-KeyDe 16 a 128 letras, dígitos, guiones bajos o guiones. Reutilízalo solo para un reintento idéntico.

Publicar nuevos precios no aumenta silenciosamente los acuerdos existentes con los clientes. Una tarifa más alta requiere consentimiento interactivo. Una aplicación no puede usar este endpoint para reemplazar los términos aceptados del cliente con un contrato más caro.

Maneja actualizaciones concurrentes#

Si la revisión o la concesión han cambiado, lee el acuerdo actual y reconsidera la operación. No incrementes la revisión ciegamente. Reutilizar una clave de idempotencia para un plan diferente es un error.

Aprende el flujo de trabajo de la Consola#

Planes de uso y consentimiento

Última actualización septiembre 15, 2026

Documentación de la plataforma ShareAI
Toda la documentación

Buscar por título o contenido.

Preguntar sobre esta página

Elige un asistente para explorar esta página. También puedes copiar la página y pegarla en tu conversación.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI