Boutique

La « boutique » est le conteneur de plus haut niveau des produits, commandes, clients, etc. Chaque clé est liée à exactement une boutique. Il n'existe aucun moyen de requêter les boutiques d'autres marchands.

`GET /v1/store`

Retourne le profil de la boutique à laquelle appartient la clé appelante.

Auth : clé plateforme avec scope store:read.

Requête

curl https://api.dzbuild.app/v1/store \
  -H "Authorization: Bearer $DZ_KEY"

Réponse 200

{
  "data": {
    "id":         13,
    "name":       "DZBuild",
    "slug":       "dzbuild",
    "language":   "ar",
    "description": "DZBuild Offers Preview",
    "logo":       "/uploads/logos/13/8e19a05f0e4205bbcd861469ec0f9257.webp",
    "favicon":    null,
    "banner":     null,
    "theme": {
      "primary_color":    "#f59e0b",
      "secondary_color":  "#fbbf24",
      "background_color": "#ffffff",
      "font_family":      "Cairo"
    },
    "subdomain":            "dzbuild.minacef.app",
    "custom_domain":        null,
    "custom_domain_verified": false,
    "public_url":            "https://dzbuild.minacef.app",
    "hide_branding":         false,
    "created_at":            "2026-01-13 14:58:23"
  },
  "meta": { "request_id": "...", "api_version": "v1" }
}

Référence des champs

Champ	Type	Notes
`id`	int	Identifiant interne stable. Identique à `store_id` partout ailleurs.
`name`	string	Nom d'affichage. Apparaît dans la navbar et les emails.
`slug`	string	Identifiant compatible URL. Utilisé dans `<slug>.dzbuild.app`, etc.
`language`	enum	`ar` ou `fr`. Détermine le sens RTL/LTR de la vitrine.
`description`	string\|null	Tagline courte.
`logo`	string\|null	Chemin sur `cdn.dzbuild.app` s'il est défini. Préfixez l'URL CDN pour l'afficher.
`favicon`	string\|null	Même logique.
`banner`	string\|null	Même logique.
`theme.primary_color`	hex string	Couleur dominante des boutons et accents.
`theme.secondary_color`	hex string	Hover / accents secondaires.
`theme.background_color`	hex string	Fond de page.
`theme.font_family`	string	Typographie (par défaut `Cairo`).
`subdomain`	string\|null	Sous-domaine émis par DZBuild (toujours présent).
`custom_domain`	string\|null	Domaine personnel du marchand. Défini uniquement s'il a été ajouté depuis le tableau de bord.
`custom_domain_verified`	bool	Vrai uniquement si DNS + SSL sont opérationnels.
`public_url`	string	URL où arrivent réellement les clients. Préfère `custom_domain` s'il est vérifié.
`hide_branding`	bool	« Powered by DZBuild » caché dans le footer. Plan Illimité.
`created_at`	timestamp	Heure de création de la boutique, fuseau serveur.

Erreurs

HTTP	Code	Cause
401	`unauthorized`	Clé invalide ou manquante
403	`forbidden`	La clé n'a pas `store:read`
404	`not_found`	La ligne de la boutique a été supprimée pendant que vous utilisiez la clé (très rare)

`PATCH /v1/store` (à venir en v1.1)

Mettre à jour les champs du profil boutique (nom, slug, couleurs du thème, domaine personnalisé).

Cet endpoint est réservé — la surface est verrouillée mais l'implémentation fait partie du jalon v1.1. En attendant, les modifications passent par le tableau de bord.

GET /v1/store​

Requête​

Réponse 200​

Référence des champs​

Erreurs​

PATCH /v1/store (à venir en v1.1)​