Référence

API REST

Chaque instance Kubuno expose une API REST publique, versionnée et en lecture seule : la marketplace (modules, catégories). Idéale pour intégrer le catalogue dans l'application Kubuno ou tout autre client.

Ouvrir la référence interactive (Swagger) →

Base & conventions #

  • Préfixe : /api/v1 · format JSON · CORS ouvert.
  • Lecture seule : seules GET/HEAD/OPTIONS ; toute écriture → 405.
  • Collections : { data, meta:{page,per_page,total,total_pages}, links } ; ressource : { data } ; erreur : { error:{status,code,message} }.

Endpoints #

MéthodeCheminRôle
GET/api/v1Découverte (liens des ressources)
GET/api/v1/modulesListe paginée (filtres category, official, featured, q, sort)
GET/api/v1/modules/{id}Détail d'un module
GET/api/v1/categoriesCatégories de la marketplace
curl 'https://votre-domaine.tld/api/v1/modules?category=Ops&sort=rating'
Astuce

Spécification machine (OpenAPI 3.0) : /api/openapi.json — utilisable pour générer des clients automatiquement.