Connexion Inscription

Webservices :

Des adresses à appeler depuis vos programmes : services JSON sur le site (sans compte ni clé), et services SOAP décrits par leur WSDL. Pour les utiliser pas à pas avec PureBasic, voir la documentation.

Principe des services JSON :

  • Adresse de base : https://koakdesign.info/?page=api (cette adresse seule liste les services disponibles).
  • Méthode GET, réponse en JSON UTF-8. Le champ ok vaut true ou false ; en cas d’erreur, erreur donne un code court et message une explication.
  • Le code HTTP suit la réponse : 200, 400 (paramètre manquant), 403 (réservé), 404 (inconnu).
  • Les réponses peuvent être gardées 5 minutes en cache : inutile d’interroger plus souvent. Pour une vérification de mise à jour, une fois au démarrage (ou une fois par jour) suffit.

Dernière version d’un logiciel :

JSON Site (OVH)

Indique la dernière version publiée d’un logiciel, ce qu’elle apporte et où la télécharger. Avec la version installée, dit si une mise à jour est disponible.

GET https://koakdesign.info/?page=api&data=version&args_0=<logiciel>&v=<version installée>

Paramètres

NomDescription
args_0obligatoireNom court du logiciel, celui de son adresse sur le site (ex. supernova).
vfacultatifVersion installée chez l’utilisateur (ex. 1.0.2). Ajoute « mise_a_jour » et la liste des nouveautés depuis cette version.

Réponse

ChampTypeDescription
okbooléentrue si la demande a abouti, false sinon (voir « erreur » et « message »).
logicieltexteNom court du logiciel.
nomtexteNom affiché.
statuttextedispo (disponible), test (en test) ou dev (en développement).
versiontexteDernière version publiée (vide si aucune encore).
datetexteDate de cette version, AAAA-MM-JJ (ou null).
notestexteNouveautés de cette version, une par ligne (\n).
pagetexteAdresse de la fiche du logiciel sur le site.
telechargertexteAdresse de téléchargement (ou null si pas de fichier).
tailletexteTaille du téléchargement (ex. 2,4 Mo).
systemetexteSystèmes compatibles.
installeetexteSeulement avec « v » : la version installée, telle que comprise par le site.
mise_a_jourbooléenSeulement avec « v » : true si une version plus récente existe.
nouveauteslisteSeulement avec « v » : toutes les versions plus récentes que celle installée (version, date, notes), la plus récente d’abord.

Erreurs

HTTPerreurQuand
400parametreLe nom du logiciel manque ou contient des caractères interdits.
403reserveLe logiciel est réservé aux membres.
404inconnuAucun logiciel publié ne porte ce nom.

Exemple de réponse (Pocket Printer, version installée 1.0)

{
    "ok": true,
    "logiciel": "pocket-printer",
    "nom": "Pocket Printer",
    "statut": "dispo",
    "version": "1.2026.11.02",
    "date": "2026-11-02",
    "notes": "Mise en téléchargement de Pocket-Printer, via un fichier Zip.",
    "page": "https://koakdesign.info/?page=software&data=view&args_0=pocket-printer",
    "telecharger": "https://koakdesign.info/?page=software&data=telecharger&args_0=pocket-printer",
    "taille": "",
    "systeme": "Windows 10 / 11, Bluetooth",
    "installee": "1.0",
    "mise_a_jour": true,
    "nouveautes": [
        {
            "version": "1.2026.11.02",
            "date": "2026-11-01",
            "notes": "Mise en téléchargement de Pocket-Printer, via un fichier Zip."
        }
    ]
}

Essayer