Anmelden

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