Zenibiz Store

Developers

API Zenibiz Store

L'API relie le builder Allo Christian au store : vérification du statut skipper, soumission d'apps et de mises à jour, consultation du catalogue publié. Tous les appels sont authentifiés par jeton.

# Authentification

curl -H "Authorization: Bearer zbs_…" \

https://www.zenibiz.app/api/apps

Authentification des utilisateurs : IDP Zenibiz

Les personnes (clients, skippers, agents, administrateurs) ne se connectent jamais avec un mot de passe du store : l'authentification est déléguée à l'IDP Zenibiz en OAuth2 « authorization code » avec PKCE et paramètre state. Le store ne stocke aucun mot de passe ; il conserve uniquement l'identifiant du compte côté IDP, l'e-mail et le nom.

  • https://idp.zenibiz.com/oauth/authorize — écran de connexion
  • https://idp.zenibiz.com/oauth/token — échange du code contre un jeton
  • https://www.zenibiz.app/auth/callback — URL de retour déclarée côté IDP
  • Les rôles restent attribués par le store : toute nouvelle identité arrive en client, skipper et agent sont validés dans l'administration.

À ne pas confondre avec les jetons d'API ci-dessous, qui authentifient des machines (le builder Allo Christian), pas des personnes.

Principes de l'API

  • Base : https://www.zenibiz.app/api · format JSON · prix en euros HT.
  • Jeton Bearer créé dans l'administration Zenibiz (en-tête Authorization) — indépendant du SSO utilisateur.
  • Seul un skipper validé peut soumettre une app ; sinon l'API répond 403.
  • Chaque soumission déclenche la checklist de conformité et renvoie le rapport.
  • La branche production du dépôt est protégée : seul Zenibiz y déploie.
GET /api/skippers/{email}/status Statut d'un skipper

Indique si le compte correspondant à l'e-mail est un skipper validé, et donc autorisé à publier sur le store.

Réponse

{
  "email": "studio@atelier-numerique.be",
  "is_skipper": true,
  "status": "active",
  "validated_at": "2026-02-11T09:30:00+01:00",
  "apps_published": 3
}
GET /api/categories Catégories d'apps

Liste des catégories actives. Le champ « category » de POST /api/submissions doit reprendre l'un de ces slugs.

Réponse

{
  "data": [
    { "slug": "pointage", "label": "Pointage & présence" },
    { "slug": "devis", "label": "Devis & chiffrage" }
  ]
}
POST /api/submissions Soumettre une app

Appelé par le bouton « Publier sur le store » du builder. Crée (ou met à jour) la fiche, lance la checklist de conformité et place la soumission en revue admin si tout est au vert. Champs obligatoires : skipper_email (e-mail d'un skipper validé), name (30 car. max), subtitle (30), category (slug de GET /api/categories), short_description (80), long_description (4000), price_monthly (nombre, € HT par mois, de 5 à 500). Facultatifs : christian_project_id (texte, 64), repo_url, support_url, privacy_url, video_url (URL, 200), version (20), features (2000), keywords (200), release_notes (2000), languages (tableau), et les booléens uses_idp, uses_wallet, uses_signatures, uses_zenipact, has_privacy_policy, has_gdpr_notice, no_secrets_in_code.

Corps de la requête

{
  "skipper_email": "studio@atelier-numerique.be",
  "christian_project_id": "163",
  "repo_url": "https://gitlab.zenibiz.app/skippers/pointeuse",
  "version": "1.0.0",
  "name": "Pointeuse Chantier",
  "subtitle": "Pointage mobile des équipes",
  "category": "pointage",
  "short_description": "Le pointage des équipes sur chantier, en 2 clics.",
  "long_description": "…",
  "price_monthly": 50,
  "support_url": "https://…/support",
  "privacy_url": "https://…/confidentialite",
  "uses_idp": true,
  "uses_wallet": true,
  "uses_signatures": false,
  "no_secrets_in_code": true,
  "has_privacy_policy": true,
  "has_gdpr_notice": true
}

Réponse

{
  "submission": "SUB-261019-A7K2M",
  "status": "in_review",
  "app": "pointeuse-chantier",
  "compliance": {
    "verdict": "passed",
    "score": 100,
    "blocking": [],
    "criteria": [{"key": "idp", "label": "Authentification via l'IDP Zenibiz", "result": "OK"}]
  }
}
GET /api/submissions/{reference} Statut d'une soumission

Retourne le statut courant de la soumission et son rapport de conformité complet, critère par critère.

POST /api/updates Soumettre une mise à jour

Déclare une nouvelle version. L'IA classe la mise à jour : mineure (déploiement automatique) ou majeure (validation admin).

Corps de la requête

{
  "app": "pointeuse-chantier",
  "version": "1.2.0",
  "type": "bugfix",
  "changelog": "Correction du calcul des heures de nuit.",
  "diff_summary": "3 fichiers modifiés, 48 lignes",
  "pr_url": "https://gitlab.zenibiz.app/skippers/pointeuse/-/merge_requests/42"
}

Réponse

{
  "app": "pointeuse-chantier",
  "version": "1.2.0",
  "classification": "minor",
  "status": "auto_deployed"
}
GET /api/apps Catalogue publié

Liste paginée des apps publiées, avec prix HT, catégorie, créateur et note moyenne. Filtres : `category`, `q`.

GET /api/apps/{slug} Fiche d'une app

Fiche complète d'une app publiée : descriptions, captures, notes de version, avis.

Webhooks sortants

Zenibiz notifie vos systèmes à chaque décision. Chaque envoi porte les en-têtes X-Zenibiz-Event et X-Zenibiz-Signature (HMAC SHA-256 du corps avec le secret de l'endpoint).

submission.approved submission.rejected update.approved update.rejected app.published

Exemple de charge utile

{
  "event": "submission.approved",
  "sent_at": "2026-10-19T10:24:00+02:00",
  "data": {
    "submission": "SUB-261019-A7K2M",
    "type": "new_app",
    "app": "pointeuse-chantier",
    "status": "approved",
    "compliance": { "verdict": "passed", "score": 100, "blocking": [] }
  }
}

Cycle de mise à jour

  1. 1. Le skipper développe sur ses propres branches.
  2. 2. Il déclare la version via POST /api/updates.
  3. 3. L'IA classe la mise à jour : mineure (correctif, sécurité, ajustement d'interface) → déploiement automatique ; majeure (fonctionnalité, intégration, tarification) → validation administrateur.
  4. 4. Le webhook update.approved ou update.rejected notifie le builder.
Demander un jeton d'API