Configure qiyaov Application Global Balance Sharing
Configure allow_consume_global. Once enabled, eligible pay-as-you-go Applications can continue using the account's global balance when their own balance is insufficient.
¶ Preparation
- Create and securely save an Account Token.
- Obtain the
application_idof an Application you own from the service application list.
export PLATFORM_TOKEN='your account token'
export APPLICATION_ID='your Application ID'
¶ API Overview
| Item | Content |
|---|---|
| Method | POST |
| URL | https://api17.platform.acedata.cloud/api/v1/applications/{application_id}/update-allow-consume-global/ |
| Auth | Account Token |
| Body | JSON |
curl -X POST \
"https://api17.platform.acedata.cloud/api/v1/applications/${APPLICATION_ID}/update-allow-consume-global/" \
-H "Authorization: Bearer ${PLATFORM_TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"allow_consume_global": true}'
On success, the updated Application object is returned. Use allow_consume_global in the response as the source of truth, rather than assuming the requested value was necessarily saved.
Applications of the
Periodtype are not allowed to consume the global balance. Even iftrueis requested, the server will keep this field asfalse.
¶ Error Handling
401: The Account Token is invalid or missing.403: The current account is not the owner of this Application.404: The Application ID does not exist.
For the global balance top-up entry point and available plans, refer to the platform console and the actual plans returned by order creation; do not assume that a Wallet type plan exists.