API Reference
VeřejnéTyp obsahu: Reference
Přehled endpointů MyBox cloudu — základní URL, Basic Auth, limit 100 požadavků za minutu, jednotný formát odpovědi a význam chybových kódů 400 až 500.
Kompletní přehled všech dostupných endpointů MyBox API.
Základní informace
- Base URL:
https://cloud.mybox.pro/admin-panel/v1 - Protokol: HTTPS (povinné)
- Autentizace: Basic Auth
- Formát: JSON
- Rate Limit: 100 požadavků/minuta
Kategorie endpointů
Zařízení (Devices)
Správa a monitoring nabíjecích stanic.
- GET /external/device - Seznam všech zařízení
- GET /external/device/{id} - Detail zařízení
- GET /external/device/{id}/events - Historie událostí
Live Data
Aktuální data z nabíjecích stanic v reálném čase.
- GET /external/live/device/{deviceId} - Live data zařízení
- GET /external/live/device/{deviceId}/telemetry - Telemetrická data
- GET /external/live/device/{deviceId}/option - Konfigurace zařízení
Historie
Historická data a statistiky.
- GET /external/history/snapshot/{deviceId} - Snapshot stavu
- GET /external/history/telemetry/{deviceId}/{telemetryId} - Historie telemetrie
- GET /external/history/sensor/{deviceId}/{nodeId}/{sensorId} - Historie senzorů
Nabíjecí relace
Správa a reporting nabíjecích relací.
- GET /external/charging-reports/device/{id} - Reporty nabíjení
- GET /external/charging-reports/owner/{email} - Relace dle vlastníka
Uživatelé a společnosti
Správa uživatelů a organizací.
- GET /external/user - Seznam uživatelů
- GET /external/company - Seznam společností
Autentizace
Všechny požadavky vyžadují Basic Authentication:
curl -X GET "https://cloud.mybox.pro/admin-panel/v1/external/device" \
-u "API_KEY:API_SECRET" \
-H "Accept: application/json"Formát odpovědi
Všechny odpovědi mají jednotný formát:
{
"status": 1, // 1 = úspěch, 0 = chyba
"data": { // Data odpovědi
// ...
},
"error": null // Chybová zpráva (pokud status = 0)
}Chybové kódy
| Kód | Význam | Řešení |
|---|---|---|
| 400 | Bad Request | Zkontrolujte formát požadavku |
| 401 | Unauthorized | Ověřte API credentials |
| 403 | Forbidden | Nemáte oprávnění k této akci |
| 404 | Not Found | Zařízení nebo endpoint neexistuje |
| 429 | Too Many Requests | Překročen rate limit |
| 500 | Internal Server Error | Chyba serveru, zkuste později |
Rychlý start s API Explorerem
Vyzkoušejte seznam vašich zařízení:
GET
/external/deviceZíská seznam všech vašich nabíjecích stanic
Autentizace
Příklady kódu
curl -X GET "https://cloud.mybox.pro/admin-panel/v1/external/device" \
-u "YOUR_API_KEY:YOUR_API_SECRET" \
-H "Accept: application/json"Další zdroje
- Swagger UI - Interaktivní dokumentace
- Praktické příklady - Ukázky použití API krok za krokem
Produkt
- Cloud platforma MyBox — co cloud umí a pro koho je určený.