Baca dan turunkan rencana penggunaan yang diterima
Baca rencana aplikasi ShareAI yang diterima pelanggan dan minta pengurangan yang diizinkan dengan pemeriksaan revisi dan kunci idempoten.
Di halaman ini
Gunakan API perjanjian aplikasi saat backend Anda perlu membaca rencana yang diterima saat ini atau menerapkan pengurangan yang diizinkan oleh perjanjian tersebut. Autentikasi sebagai klien aplikasi yang memiliki subjek pelanggan.
https://auth.shareai.now/oauth/agreements/{subject}Baca hibah yang diterima dan rencana saat ini.
- URL Dasar
https://auth.shareai.now- Otentikasi
- HTTP Basic: ID klien dan rahasia klien
cURL
curl --fail-with-body "https://auth.shareai.now/oauth/agreements/$SHAREAI_SUBJECT" \
-u "$SHAREAI_CLIENT_ID:$SHAREAI_CLIENT_SECRET"
Respons mencakup grant_id, revision, plan_id, status dan informasi penerimaan. Pertahankan hibah saat ini dan revisi saat mempersiapkan perubahan.
https://auth.shareai.now/oauth/agreements/{subject}Terapkan pengurangan yang diizinkan dalam kontrak yang diterima.
- URL Dasar
https://auth.shareai.now- Otentikasi
- HTTP Basic: ID klien dan rahasia klien
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"}'
| Bidang | Aturan |
|---|---|
subject | Gunakan subjek akun buram klien ini. |
grant_id | Gunakan hibah yang dikembalikan oleh pembacaan terbaru. |
revision | Gunakan revisi saat ini; segarkan status setelah konflik. |
plan_id | Pilih rencana yang lebih rendah yang diizinkan dalam kontrak yang diterima. |
Idempotency-Key | 16–128 huruf, angka, garis bawah, atau tanda hubung. Gunakan ulang hanya untuk pengulangan identik. |
Biaya lebih tinggi memerlukan persetujuan baru#
Menerbitkan harga baru tidak secara diam-diam meningkatkan perjanjian pelanggan yang ada. Biaya yang lebih tinggi memerlukan persetujuan interaktif. Aplikasi tidak dapat menggunakan endpoint ini untuk mengganti syarat yang diterima pelanggan dengan kontrak yang lebih mahal.
Tangani pembaruan bersamaan#
Jika revisi atau hibah telah berubah, baca perjanjian saat ini dan pertimbangkan kembali operasi. Jangan secara sembarangan meningkatkan revisi. Kunci idempoten yang digunakan ulang untuk rencana yang berbeda adalah kesalahan.
Pelajari alur kerja Console#
Terakhir diperbarui 15 September 2026