Basahin at babaan ang tinanggap na plano ng paggamit

Basahin ang tinanggap na ShareAI application plan ng customer at humiling ng pinapayagang pagbabawas gamit ang mga pagsusuri sa revision at isang idempotency key.

Tingnan bilang Markdown

Sa pahinang ito

Gamitin ang application agreement API kapag kailangang basahin ng iyong backend ang kasalukuyang tinanggap na plano o mag-aplay ng pagbabawas na pinapayagan ng kasunduan na iyon. Mag-authenticate bilang application client na nagmamay-ari ng subject ng customer.

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

Basahin ang tinanggap na grant at kasalukuyang plano.

Base URL: https://auth.shareai.now
Pagpapatunay: HTTP Basic: client ID at client secret

cURL

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

Kasama sa tugon grant_id, revision, plan_id, status at impormasyon ng pagtanggap. Panatilihin ang kasalukuyang grant at rebisyon kapag naghahanda ng pagbabago.

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

Mag-apply ng pinahihintulutang pagbabawas sa loob ng tinanggap na kontrata.

Base URL: https://auth.shareai.now
Pagpapatunay: HTTP Basic: client ID at client secret

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

Patlang	Panuntunan
`subject`	Gamitin ang opaque na subject ng account ng kliyenteng ito.
`grant_id`	Gamitin ang grant na ibinalik ng pinakahuling pagbabasa.
`revision`	Gamitin ang kasalukuyang rebisyon; i-refresh ang estado pagkatapos ng isang salungatan.
`plan_id`	Pumili ng pinapayagang mas mababang plano sa tinanggap na kontrata.
`Idempotency-Key`	16–128 letra, numero, underscores o hyphens. Gamitin muli lamang para sa parehong retry.

Ang pag-publish ng bagong presyo ay hindi tahimik na magtataas ng umiiral na kasunduan ng customer. Ang mas mataas na bayad ay nangangailangan ng interaktibong pahintulot. Ang isang aplikasyon ay hindi maaaring gamitin ang endpoint na ito upang palitan ang tinanggap na mga termino ng customer ng mas mahal na kontrata.

Pangasiwaan ang sabay-sabay na mga update#

Kung nagbago ang rebisyon o grant, basahin ang kasalukuyang kasunduan at muling isaalang-alang ang operasyon. Huwag basta-basta mag-increment ng rebisyon. Ang idempotency key na ginamit muli para sa ibang plano ay isang error.

Alamin ang workflow ng Console#

Mga plano sa paggamit at pahintulot

Huling na-update noong Setyembre 15, 2026

Ang mas mataas na bayad ay nangangailangan ng bagong pahintulot#

Pangasiwaan ang sabay-sabay na mga update#

Alamin ang workflow ng Console#