Cloud API
Cloud API
The desktop app and the customer portal talk to the Rotavue cloud API. Most customers never call it directly; this page lists what exists. For request and response bodies, ask vietprohub@gmail.com.
Base URL: https://api.rotavue.vietprohub.com/api/v1.
Licence (used by the desktop app)
| Method and path | Purpose |
|---|---|
POST /licenses/activate | Bind a seat to a machine and return a signed token |
POST /licenses/validate | Re-check a token |
POST /licenses/refresh | Renew a token |
POST /licenses/deactivate | Release the seat |
POST /licenses/trial | Email a 14-day trial key (one per mailbox and device) |
Customer portal
POST /portal/login signs in with your email and licence key and sets an HttpOnly session cookie; requests
that change anything also need the X-Requested-With: o2vr-portal header. Other portal routes list your
machines, subscription and invoices, deactivate a machine and change plan.
Cloud sync (Studio, Enterprise, trial)
GET /sync/list, POST /sync/push (returns a presigned upload URL), POST /sync/finalize,
GET /sync/pull/{project_id}, DELETE /sync/{project_id}. Only the project file is stored.
Updates
GET /update/{platform}/{arch}/{current_version} returns the signed update manifest the desktop app uses.
Errors and limits
| Code | Meaning |
|---|---|
401 | Missing or invalid token |
403 | Licence revoked or expired, or a missing CSRF header on the portal |
413 | Over the sync storage quota |
429 | Rate limit exceeded; wait for the time in Retry-After |