Consultez et réduisez un plan d'utilisation accepté
Lire le plan d’application ShareAI accepté par un client et demander une diminution autorisée avec des vérifications de révision et une clé d’idempotence.
Sur cette page
Utilisez l’API d’accord d’application lorsque votre backend doit lire le plan accepté actuel ou appliquer une diminution autorisée par cet accord. Authentifiez-vous en tant que client de l’application propriétaire du sujet du client.
https://auth.shareai.now/oauth/agreements/{subject}Lire la subvention acceptée et le plan actuel.
- URL de base
https://auth.shareai.now- Authentification
- HTTP Basic : ID client et secret client
cURL
curl --fail-with-body "https://auth.shareai.now/oauth/agreements/$SHAREAI_SUBJECT" \
-u "$SHAREAI_CLIENT_ID:$SHAREAI_CLIENT_SECRET"
La réponse inclut grant_id, revision, plan_id, les informations sur le statut et l'acceptation. Conservez la subvention actuelle et la révision lors de la préparation d'un changement.
https://auth.shareai.now/oauth/agreements/{subject}Appliquez une diminution autorisée dans le cadre du contrat accepté.
- URL de base
https://auth.shareai.now- Authentification
- HTTP Basic : ID client et secret client
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"}'
| Champ | Règle |
|---|---|
subject | Utilisez le sujet opaque du compte de ce client. |
grant_id | Utilisez la subvention renvoyée par la dernière lecture. |
revision | Utilisez la révision actuelle ; actualisez l'état après un conflit. |
plan_id | Choisissez un plan inférieur autorisé dans le contrat accepté. |
Idempotency-Key | 16 à 128 lettres, chiffres, underscores ou tirets. Réutilisez uniquement pour une tentative identique. |
Un tarif plus élevé nécessite un nouveau consentement#
Publier de nouveaux tarifs n'augmente pas silencieusement les accords existants avec les clients. Un tarif plus élevé nécessite un consentement interactif. Une application ne peut pas utiliser cet endpoint pour remplacer les conditions acceptées par le client par un contrat plus coûteux.
Gérer les mises à jour simultanées#
Si la révision ou la subvention a changé, lisez l'accord actuel et reconsidérez l'opération. Ne modifiez pas aveuglément la révision. Une clé d'idempotence réutilisée pour un plan différent constitue une erreur.
Apprendre le flux de travail de la Console#
Dernière mise à jour le 15 septembre 2026