Đọc và giảm kế hoạch sử dụng đã được chấp nhận
Đọc kế hoạch ứng dụng ShareAI đã được khách hàng chấp nhận và yêu cầu giảm phí được phép với các kiểm tra sửa đổi và một khóa idempotency.
Trên trang này
Sử dụng API thỏa thuận ứng dụng khi backend của bạn cần đọc kế hoạch hiện tại đã được chấp nhận hoặc áp dụng giảm phí được phép bởi thỏa thuận đó. Xác thực như là khách hàng ứng dụng sở hữu đối tượng của khách hàng.
https://auth.shareai.now/oauth/agreements/{subject}Đọc khoản trợ cấp đã chấp nhận và kế hoạch hiện tại.
- URL cơ sở
https://auth.shareai.now- Xác thực
- HTTP Basic: ID khách hàng và bí mật khách hàng
cURL
curl --fail-with-body "https://auth.shareai.now/oauth/agreements/$SHAREAI_SUBJECT" \
-u "$SHAREAI_CLIENT_ID:$SHAREAI_CLIENT_SECRET"
Phản hồi bao gồm grant_id, revision, plan_id, thông tin trạng thái và chấp nhận. Giữ nguyên khoản trợ cấp hiện tại và bản sửa đổi khi chuẩn bị thay đổi.
https://auth.shareai.now/oauth/agreements/{subject}Áp dụng mức giảm được phép trong hợp đồng đã chấp nhận.
- URL cơ sở
https://auth.shareai.now- Xác thực
- HTTP Basic: ID khách hàng và bí mật khách hàng
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"}'
| Trường | Quy tắc |
|---|---|
subject | Sử dụng đối tượng tài khoản không rõ ràng của khách hàng này. |
grant_id | Sử dụng quyền truy cập được trả về bởi lần đọc mới nhất. |
revision | Sử dụng phiên bản hiện tại; làm mới trạng thái sau khi có xung đột. |
plan_id | Chọn một gói thấp hơn được phép trong hợp đồng đã chấp nhận. |
Idempotency-Key | 16–128 chữ cái, chữ số, dấu gạch dưới hoặc dấu gạch ngang. Tái sử dụng chỉ cho một lần thử lại giống hệt. |
Một phí cao hơn cần sự đồng ý mới#
Việc công bố giá mới không tự động tăng các thỏa thuận khách hàng hiện có. Một mức phí cao hơn yêu cầu sự đồng ý tương tác. Một ứng dụng không thể sử dụng endpoint này để thay thế các điều khoản đã được khách hàng chấp nhận bằng một hợp đồng đắt hơn.
Xử lý các cập nhật đồng thời#
Nếu phiên bản hoặc quyền truy cập đã thay đổi, hãy đọc thỏa thuận hiện tại và xem xét lại thao tác. Không tăng phiên bản một cách mù quáng. Một khóa idempotency được tái sử dụng cho một gói khác là một lỗi.
Tìm hiểu quy trình làm việc của Console#
Cập nhật lần cuối Tháng 9 15, 2026