Vue d’ensemble des points d’accès
Le tableau ci-dessous reprend les routes publiques déclarées dans backend-public-api/app.js. Les chemins sont affichés avec le préfixe du proxy public utilisé par les intégrations externes.
| Méthode | Point d’accès | Description | Accès |
|---|---|---|---|
GET | /public-api/healthz | Vérification de la disponibilité du service. | public |
GET | /public-api/v1/auth/check | Valide les identifiants et renvoie la boutique, les portées et les fonctionnalités de l’offre. | tout identifiant authentifié |
GET | /public-api/v1/customer-orders | Renvoie une liste paginée et filtrable des commandes clients. | orders:read |
GET | /public-api/v1/customer-orders/:id | Renvoie une commande client avec ses articles configurés. | orders:read |
POST | /public-api/v1/customer-orders/batch | Renvoie jusqu’à 100 commandes par identifiant. | orders:read |
PATCH | /public-api/v1/customer-orders/:id/status | Met à jour le statut de la commande. | orders:write |
PATCH | /public-api/v1/customer-orders/:orderId/quantity | Met à jour les quantités des lignes de commande sélectionnées. | orders:write |
PATCH | /public-api/v1/customer-orders/:orderId/quantity/all | Définit une même quantité pour chaque article d’une commande. | orders:write |
DELETE | /public-api/v1/customer-orders/:id | Supprime une commande client appartenant au propriétaire de la boutique. | orders:write |
GET | /public-api/v1/products | Renvoie les produits/designs de la boutique avec les possibilités d’intégration et les URL des médias. | products:read |
GET | /public-api/v1/products/:id | Renvoie un produit/design de la boutique. | products:read |
POST | /public-api/v1/embed/session | Émet un JWT de courte durée pour les outils intégrés, dont le générateur de modèles. | embed:session:create |
GET | /public-api/v1/runtime/bootstrap | Détermine le contexte d’exécution à partir d’un JWT d’intégration. | jeton d’intégration Bearer |
GET | /public-api/v1/assets | Liste les éléments du catalogue de ressources du type demandé. | tout identifiant authentifié |
GET | /public-api/v1/assets/:type/:assetId | Renvoie le manifeste d’une ressource avec les rôles de ses fichiers téléchargeables. | tout identifiant authentifié |
GET | /public-api/v1/assets/:type/:assetId/files/:role | Télécharge un fichier de ressource selon son rôle. | tout identifiant authentifié |
GET | /public-api/v1/design-imports | Liste les designs hébergés chez Alter pouvant être importés. | identifiant authentifié, offre Business requise |
GET | /public-api/v1/design-imports/:id | Renvoie les données d’import d’un design et les descripteurs de fichiers. | identifiant authentifié, offre Business requise |
GET | /public-api/v1/design-imports/:id/files/:fileId | Télécharge un fichier à partir d’un descripteur d’import de design. | identifiant authentifié, offre Business requise |
GET | /public-api/v1/file/public/products/:productId/:size | Renvoie un aperçu public de produit. La taille doit être small.png, medium.png ou big.png. | public |
GET | /public-api/v1/file/protected/:key | Renvoie un fichier protégé à partir de sa clé de stockage. | URL signée ou files:read |
GET | /public-api/v1/fonts | Renvoie toutes les polices disponibles. | public |
GET | /public-api/v1/currencies | Renvoie toutes les devises. | public |
POST | /public-api/v1/runtime-bindings/sync-from-wordpress | Crée ou met à jour les associations d’exécution à partir des associations de produits WordPress. | tout identifiant authentifié |
PATCH | /public-api/v1/runtime-bindings/:id | Modifie une association d’exécution. | tout identifiant authentifié |
POST | /public-api/v1/runtime-bindings/:id/activate | Active une association d’exécution. | tout identifiant authentifié |
POST | /public-api/v1/runtime-bindings/:id/deactivate | Désactive une association d’exécution. | tout identifiant authentifié |
POST | /public-api/v1/wp-connect/exchange | Échange un code de transfert de connexion automatique WordPress contre des identifiants API. | code de transfert à usage unique |
GET | /public-api/v1/model-generator/catalog | Liste les produits du générateur, les configurations et les révisions de gabarits visibles. | embed:session:create |
GET | /public-api/v1/model-generator/models | Liste les modèles avec des descripteurs de sources du générateur liés à des révisions précises pour l’import. | embed:session:create |
GET | /public-api/v1/model-generator/designer-catalog | Renvoie le catalogue de modèles du générateur utilisé par Designer. | embed:session:create |
GET | /public-api/v1/model-generator/projects | Liste les projets du générateur appartenant au propriétaire et ceux disponibles globalement. | embed:session:create |
GET | /public-api/v1/model-generator/projects/:projectId | Renvoie la révision la plus récente ou sélectionnée du projet, le gabarit et le manifeste des fichiers. | embed:session:create |
GET | /public-api/v1/model-generator/projects/:projectId/revisions/:revision | Renvoie la révision la plus récente ou sélectionnée du projet, le gabarit et le manifeste des fichiers. | embed:session:create |
GET | /public-api/v1/model-generator/projects/:projectId/artifacts/:artifactId | Télécharge un artefact après vérification de l’accès à son projet. | embed:session:create |
GET | /public-api/v1/model-generator/configurations/:configurationId/revisions/:revision/template | Renvoie un document de gabarit accessible pour la révision de configuration sélectionnée. | embed:session:create |
GET | /public-api/v1/model-generator/configurations/:configurationId/revisions/:revision/import | Renvoie le paquet d’import du gabarit avec les fichiers de dépendances. | embed:session:create |
GET | /public-api/v1/model-generator/mannequins | Renvoie les deux mannequins et les descripteurs de leurs ressources. | embed:session:create |
GET | /public-api/v1/model-generator/image-libraries/:kind/assets | Liste les ressources des bibliothèques de textures ou d’arrière-plans avec les fichiers importables. | embed:session:create |
GET | /public-api/v1/model-generator/image-libraries/:kind/assets/:assetId | Renvoie une ressource de texture ou d’arrière-plan avec ses fichiers importables. | embed:session:create |
GET | /public-api/v1/model-generator/public-files/:key | Télécharge un fichier de dépendance autorisé du générateur. | embed:session:create |