Download- und Update-API
Über diese REST-Schnittstelle laden BBasic und andere Programme gekaufte Apps und halten sie aktuell – ähnlich der automatischen Aktualisierung im Play Store.
Anmeldung per Token: Authorization: Bearer bbs_…. Ein Token erzeugen Sie unter Konto oder per POST /api/v1/token.
1. Token holen
POST https://shop.bbasic.de/api/v1/token
{ "eMail": "kunde@example.de", "passwort": "…", "geraet": "BBasic Büro-PC" }
→ { "token": "bbs_…", "konto": { … } }
2. Gekaufte Apps (Bibliothek)
GET https://shop.bbasic.de/api/v1/bibliothek?typ=Makro
→ [ { "slug": "…", "name": "…", "typ": "Makro", "neueste": { "id": 12, "versionsName": "1.2.0", "versionsCode": 3, "sha256": "…", "download": "…/api/v1/download/12" } } ]
Typen: Kpl, DllPlugin, Makro, ProDatei, Android, Ios, BlazorWeb.
3. Updates prüfen
POST https://shop.bbasic.de/api/v1/updates
{ "installiert": [ { "slug": "zz-mahnwesen-plus", "versionsCode": 1 } ], "auchNichtInstallierte": true }
→ { "updates": [ … ], "nichtInstalliert": [ … ] }
4. Herunterladen
GET https://shop.bbasic.de/api/v1/download/{versionId}
→ Datei · Header X-BBShop-Sha256, X-BBShop-Version, X-BBShop-VersionCode
Nach dem Download die SHA-256-Prüfsumme vergleichen, dann installieren (KPL/Makro/PRO in das BBasic-Verzeichnis, DLL-Plugins in den Plugin-Ordner).
Weitere
GET https://shop.bbasic.de/api/v1/katalog?suche=&typ=&kategorie= (ohne Token)
GET https://shop.bbasic.de/api/v1/apps/{slug} (Details, Versionen; mit Token inkl. „besitzt“)
GET https://shop.bbasic.de/api/v1/apps/{slug}/neueste
Beispiel PowerShell
$h = @{ Authorization = "Bearer bbs_…" }
Invoke-RestMethod https://shop.bbasic.de/api/v1/bibliothek -Headers $h
Invoke-WebRequest https://shop.bbasic.de/api/v1/download/12 -Headers $h -OutFile app.kpl