Lesen und senken Sie einen akzeptierten Nutzungsplan

Lesen Sie den akzeptierten ShareAI-Anwendungsplan eines Kunden und fordern Sie eine erlaubte Reduzierung mit Revisionsprüfungen und einem Idempotenzschlüssel an.

Als Markdown anzeigen

Auf dieser Seite

Verwenden Sie die API für Anwendungsvereinbarungen, wenn Ihr Backend den aktuellen akzeptierten Plan lesen oder eine durch diese Vereinbarung erlaubte Reduzierung anwenden muss. Authentifizieren Sie sich als der Anwendungsclient, der das Subjekt des Kunden besitzt.

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

Lesen Sie die akzeptierte Genehmigung und den aktuellen Plan.

Basis-URL: https://auth.shareai.now
Authentifizierung: HTTP Basic: Client-ID und Client-Geheimnis

cURL

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

Die Antwort enthält grant_id, revision, plan_id, Status- und Akzeptanzinformationen. Behalten Sie den aktuellen Grant und die Revision bei, wenn Sie eine Änderung vorbereiten.

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

Wenden Sie eine zulässige Reduzierung innerhalb des akzeptierten Vertrags an.

Basis-URL: https://auth.shareai.now
Authentifizierung: HTTP Basic: Client-ID und Client-Geheimnis

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"}'

Feld	Regel
`subject`	Verwenden Sie das undurchsichtige Kontosubjekt dieses Clients.
`grant_id`	Verwenden Sie die Berechtigung, die durch die letzte Abfrage zurückgegeben wurde.
`revision`	Verwenden Sie die aktuelle Revision; aktualisieren Sie den Status nach einem Konflikt.
`plan_id`	Wählen Sie einen zulässigen niedrigeren Plan im akzeptierten Vertrag.
`Idempotency-Key`	16–128 Buchstaben, Ziffern, Unterstriche oder Bindestriche. Wiederverwenden Sie nur für einen identischen Wiederholungsversuch.

Neue Preise zu veröffentlichen erhöht nicht stillschweigend bestehende Kundenvereinbarungen. Eine höhere Gebühr erfordert eine interaktive Zustimmung. Eine Anwendung kann diesen Endpunkt nicht verwenden, um die akzeptierten Bedingungen des Kunden durch einen teureren Vertrag zu ersetzen.

Gleichzeitige Updates verwalten#

Wenn sich die Revision oder Berechtigung geändert hat, lesen Sie die aktuelle Vereinbarung und überdenken Sie die Operation. Erhöhen Sie die Revision nicht blind. Ein Idempotenzschlüssel, der für einen anderen Plan wiederverwendet wird, ist ein Fehler.

Lernen Sie den Console-Workflow kennen#

Nutzungspläne und Zustimmung

Zuletzt aktualisiert am 15. September 2026

Eine höhere Gebühr erfordert neue Zustimmung#

Gleichzeitige Updates verwalten#

Lernen Sie den Console-Workflow kennen#