Billing & Subscriptions
FreshBalance Inquiry
URL: https://openapi.geelark.com/open/v1/pay/walletMethod: POST Rate limit: 10 requests/minute
Response
| Field | Type | Description |
|---|---|---|
| balance | float | Account balance |
| giftMoney | float | Gifted amount |
| availableTimeAddOn | int | Remaining time add-on |
json
{
"code": 0,
"data": {
"balance": 1549.77,
"giftMoney": 0,
"availableTimeAddOn": 10
}
}Get Plan List
URL: https://openapi.geelark.com/open/v1/pay/profiles/listMethod: POST
Response
| Field | Type | Description |
|---|---|---|
| id | string | Plan ID |
| price | float | Monthly price |
| level | int | 0=Base, 1=Pro |
| envNum | int | Max environments |
| freeTime | int | Free minutes included |
| openEnvNumOneDay | int | Max opens per day |
| createEnvNumOneDay | int | Max creates per day |
Change Plan (Upgrade)
URL: https://openapi.geelark.com/open/v1/pay/plan/upgradeMethod: POST
WARNING
Only upgrades are supported via API. Downgrades must be done through the GEELark client.
| Parameter | Required | Type | Description |
|---|---|---|---|
| profilesId | Yes | string | Plan ID (from get plan list) |
| parallelsNum | Yes | int | Must be >= current parallels |
| monthlyRentalNum | Yes | int | Must be >= current monthly rentals |
| days | No | int | Required if plan expired: 30/90/180/360 |
| promoCode | No | string | Promo code |
Renew Plan
URL: https://openapi.geelark.com/open/v1/pay/plan/continueMethod: POST
| Parameter | Required | Type | Description |
|---|---|---|---|
| days | Yes | int | Duration: 30/90/180/360 days |
| promoCode | No | string | Promo code |
Get Current Subscription Info
URL: https://openapi.geelark.com/open/v1/pay/plan/infoMethod: POST Rate limit: 1 request/minute
Response
| Field | Type | Description |
|---|---|---|
| plan | integer | 0=Base, 1=Pro |
| profiles | integer | Total profiles |
| monthlyRental | integer | Monthly rental devices |
| parallels | integer | Parallel limit |
| expirationTime | integer | Expiration timestamp |
| monthlyFee | float | Monthly billing amount |
| availableProfiles | integer | Available profiles |
| availableMonthlyRentals | integer | Available monthly rentals |
Error Codes
| Code | Description |
|---|---|
| 41001 | Insufficient balance |
| 41002 | Only upgrades supported via API |
| 41003 | Promo code is invalid |