Citește și reduce un plan de utilizare acceptat
Citește planul de aplicație ShareAI acceptat de un client și solicită o reducere permisă cu verificări de revizuire și o cheie de idempotentă.
Pe această pagină
Utilizează API-ul de acord al aplicației atunci când backend-ul tău trebuie să citească planul acceptat curent sau să aplice o reducere permisă de acel acord. Autentifică-te ca client al aplicației care deține subiectul clientului.
https://auth.shareai.now/oauth/agreements/{subject}Citește acordul acceptat și planul curent.
- URL de bază
https://auth.shareai.now- Autentificare
- HTTP Basic: ID-ul clientului și secretul clientului
cURL
curl --fail-with-body "https://auth.shareai.now/oauth/agreements/$SHAREAI_SUBJECT" \
-u "$SHAREAI_CLIENT_ID:$SHAREAI_CLIENT_SECRET"
Răspunsul include grant_id, revision, plan_id, informații despre status și acceptare. Păstrează grantul curent și revizia atunci când pregătești o modificare.
https://auth.shareai.now/oauth/agreements/{subject}Aplică o reducere permisă în cadrul contractului acceptat.
- URL de bază
https://auth.shareai.now- Autentificare
- HTTP Basic: ID-ul clientului și secretul clientului
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"}'
| Câmp | Regulă |
|---|---|
subject | Utilizează subiectul opac al contului acestui client. |
grant_id | Utilizează grantul returnat de cea mai recentă citire. |
revision | Utilizează revizia curentă; actualizează starea după un conflict. |
plan_id | Alege un plan inferior permis în contractul acceptat. |
Idempotency-Key | 16–128 litere, cifre, sublinieri sau cratime. Reutilizează doar pentru o reluare identică. |
O taxă mai mare necesită un nou consimțământ#
Publicarea unor prețuri noi nu crește în mod silențios acordurile existente cu clienții. O taxă mai mare necesită consimțământ interactiv. O aplicație nu poate utiliza acest endpoint pentru a înlocui termenii acceptați ai clientului cu un contract mai scump.
Gestionează actualizările simultane#
Dacă revizia sau grantul s-au schimbat, citește acordul curent și reconsideră operațiunea. Nu incrementa revizia fără verificare. O cheie de idempotentă reutilizată pentru un plan diferit este o eroare.
Află fluxul de lucru din Consolă#
Ultima actualizare: 15 septembrie 2026