승인된 사용 계획 읽기 및 낮추기
고객이 승인한 ShareAI 애플리케이션 플랜을 읽고 수정 키와 함께 허용된 감소를 요청하십시오.
이 페이지에서
백엔드에서 현재 승인된 플랜을 읽거나 해당 계약에 의해 허용된 감소를 적용해야 할 때 애플리케이션 계약 API를 사용하십시오. 고객의 주체를 소유한 애플리케이션 클라이언트로 인증하십시오.
GET
https://auth.shareai.now/oauth/agreements/{subject}승인된 부여 및 현재 플랜 읽기.
- 기본 URL
https://auth.shareai.now- 인증
- HTTP Basic: 클라이언트 ID 및 클라이언트 비밀
cURL
curl --fail-with-body "https://auth.shareai.now/oauth/agreements/$SHAREAI_SUBJECT" \
-u "$SHAREAI_CLIENT_ID:$SHAREAI_CLIENT_SECRET"
응답에는 grant_id, revision, plan_id, 상태 및 승인 정보. 변경을 준비할 때 현재 승인 및 개정을 유지하십시오.
POST
https://auth.shareai.now/oauth/agreements/{subject}승인된 계약 내에서 허용된 감소를 적용하십시오.
- 기본 URL
https://auth.shareai.now- 인증
- HTTP Basic: 클라이언트 ID 및 클라이언트 비밀
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"}'
| 필드 | 규칙 |
|---|---|
subject | 이 클라이언트의 불투명한 계정 주제를 사용하세요. |
grant_id | 최신 읽기에서 반환된 권한을 사용하세요. |
revision | 현재 개정을 사용하세요; 충돌 후 상태를 새로 고치세요. |
plan_id | 승인된 계약에서 허용된 낮은 플랜을 선택하세요. |
Idempotency-Key | 16–128개의 문자, 숫자, 밑줄 또는 하이픈. 동일한 재시도에만 재사용하세요. |
더 높은 요금은 새로운 동의가 필요합니다.#
새로운 가격을 게시한다고 기존 고객 계약이 자동으로 증가하지 않습니다. 더 높은 요금은 상호 동의가 필요합니다. 애플리케이션은 이 엔드포인트를 사용하여 고객이 승인한 조건을 더 비싼 계약으로 대체할 수 없습니다.
동시 업데이트 처리#
개정 또는 권한이 변경된 경우 현재 계약을 읽고 작업을 재고하세요. 개정을 맹목적으로 증가시키지 마세요. 다른 플랜에 재사용된 멱등성 키는 오류입니다.
콘솔 워크플로 배우기#
마지막 업데이트 9월 15, 2026