Deze gids is bedoeld voor partners die SphereOX-binaire pakketten mogen publiceren op de TIARC Lounge, handmatig of vanuit hun CI-pijplijn.

Vereisten

• Een Lounge-account met de rol Uitgever, goedgekeurd door TIARC. Vraag het aan via contact@tiarc.be.
• Maximale bestandsgrootte: 512 MB.
• Toegestane achtervoegsels: .tar.gz .tgz .tar.xz .tar.zst .zip .deb .rpm .apk .img .iso .bin .efi .sig .asc .sha256
• Beschikbare kanalen: stable, beta, dev.

Handmatig uploaden (webformulier)

1. Meld u aan op de pagina Mijn account.
2. Vul in de sectie “Een pakket publiceren” de naam (bv. sphereox-core), versie, kanaal en platform in.
3. Selecteer het binaire bestand. U kunt de verwachte SHA-256-checksum opgeven: de server controleert die en weigert de upload bij een verschil.
4. Klik op “Publiceren”: het pakket verschijnt onmiddellijk in de catalogus.

Uploaden via de API (CI/CD)

1. Een API-token aanmaken

De API gebruikt WordPress applicatiewachtwoorden (Basic-authenticatie over HTTPS). Maak in uw Lounge-profiel (wp-admin → Profiel → Applicatiewachtwoorden) een wachtwoord aan, bv. “ci-sphereox”, en bewaar het veilig (het wordt niet opnieuw getoond).

2. Een pakket publiceren

curl -u "utilisateur:mot-de-passe-application" 
  -F "file=@sphereox-core-1.4.2.tar.gz" 
  -F "name=sphereox-core" 
  -F "version=1.4.2" 
  -F "channel=stable" 
  -F "platform=x86_64" 
  -F "description=Noyau SphereOX" 
  -F "sha256=$(sha256sum sphereox-core-1.4.2.tar.gz | cut -d' ' -f1)" 
  https://lounge.tiarc.be/wp-json/tiarc-lounge/v1/packages

Antwoord: 201 Created met de pakketmetadata (id, berekende sha256, download_url). Het veld sha256 is optioneel maar sterk aanbevolen: bij een verschil wordt de upload geweigerd (400).

3. Beschikbare endpoints

• GET https://lounge.tiarc.be/wp-json/tiarc-lounge/v1/packages — publieke catalogus (filters ?name= en ?channel=).
• GET https://lounge.tiarc.be/wp-json/tiarc-lounge/v1/packages/<id> — pakketdetails.
• GET https://lounge.tiarc.be/wp-json/tiarc-lounge/v1/packages/latest?name=&channel= — laatst gepubliceerde versie.
• GET https://lounge.tiarc.be/wp-json/tiarc-lounge/v1/packages/<id>/download — binair bestand (authenticatie vereist).
• POST https://lounge.tiarc.be/wp-json/tiarc-lounge/v1/packages — publiceren (rol Uitgever vereist).

Pakketten ophalen

Laatste versie van een pakket (publieke metadata):

curl "https://lounge.tiarc.be/wp-json/tiarc-lounge/v1/packages/latest?name=sphereox-core&channel=stable"

Binaire download (goedgekeurd Lounge-account):

curl -u "utilisateur:mot-de-passe-application" -OJ 
  "https://lounge.tiarc.be/wp-json/tiarc-lounge/v1/packages/<id>/download"

Een RSS-feed van nieuwe releases is beschikbaar: lounge.tiarc.be/?feed=sphereox-releases.

Goede praktijken

• Versioneer volgens SemVer (MAJOR.MINOR.PATCH).
• Publiceer altijd de SHA-256-checksum; controleer die na het downloaden.
• Reserveer stable voor gevalideerde releases; gebruik anders beta/dev.
• Eén API-token per systeem (CI, werkstation): trek het individueel in bij een lek.