Modèles de la place de marché

Ce qu’apportent les mises en page prêtes à l’emploi

La place de marché propose des bases conçues par PDFgine pour propositions, rapports, présentations et documents similaires. Une fois le modèle ajouté à votre espace, vous pouvez modifier textes, données, couleurs et mise en page dans le Générateur.

Pour le moment, seul PDFgine publie des modèles sur la place de marché. Aucun parcours éditeur ne permet aux clients de vendre leurs propres modèles.

Types d’accès

• Gratuit : un utilisateur disposant des droits nécessaires peut ajouter directement le modèle à l’espace de travail.
• Inclus dans l’offre : aucun supplément si votre abonnement actif inclut le modèle.
• Payant : le modèle peut être installé dans l’espace de travail concerné après vérification de son paiement unique.

Obtenir et utiliser un modèle

1. Trouvez une mise en page par catégorie ou recherche, puis examinez sa couverture et sa description.
2. Ajoutez un modèle gratuit ou inclus dans votre offre, ou finalisez le paiement sécurisé d’une mise en page payante.
3. L’installation ajoute une copie modifiable de la mise en page à la section Modèles de l’espace de travail sélectionné.
4. Ouvrez-le dans le Générateur, remplacez les données d’exemple par les vôtres et vérifiez les sorties PDF, Word et Visionneuse avant de publier.

Le code du modèle doit être unique dans l’espace de travail. Une collision n’écrase jamais le modèle existant ; un autre code vous est demandé.

Publier et installer via l’API

Tout ce que fait l’écran de la place de marché est disponible via un point de terminaison : lister les éléments publiés, copier un modèle dans votre compte, publier l’un des vôtres et définir son prix.

# Lister les éléments publiés
curl -s "https://api.pdfgine.com/api/v1/marketplace/templates?locale=en" \
  -H "X-PDFgine-Key: $PDFGINE_KEY"

# En copier un dans votre propre compte
curl -X POST https://api.pdfgine.com/api/v1/marketplace/templates/consulting-proposal/install \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "code": "proposal", "name": "Proposition" }'

# Publier l’un des vôtres
curl -X POST https://api.pdfgine.com/api/v1/templates/invoice/marketplace \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "title": "Facture avec conditions de paiement",
        "summary": "Un modèle de facturation avec conditions de paiement et bloc de totaux.",
        "category": "reports",
        "locale": "en",
        "license": "commercial",
        "visibility": "public",
        "confirmAssetRedistributionRights": true
      }'

# Définir son prix - priceMinorUnits est requis lorsque isFree vaut false
curl -X PUT https://api.pdfgine.com/api/v1/marketplace/templates/invoice-with-payment-terms/offer \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "isFree": false,
        "priceMinorUnits": 4900,
        "currency": "USD",
        "includedPlanCodes": ["business", "enterprise"],
        "expectedVersion": 3
      }'

L’installation copie le modèle dans votre compte ; les modifications ultérieures de l’éditeur n’affectent pas votre copie. La publication vous demande de confirmer que vous pouvez redistribuer les polices et images du modèle ; cette confirmation est enregistrée.

Vos propres graphiques et modèles

Créer votre propre modèle ou graphique ne nécessite aucun achat sur la place de marché. Ce qui est vendu est la mise en page prête à l’emploi conçue par PDFgine.

Les problèmes les plus courants

• L’installation copie la mise en page dans votre espace de travail. Les modifications ultérieures de l’éditeur n’affectent pas cette copie et vos modifications ne sont jamais écrasées.
• Le code doit être disponible dans votre espace de travail. Une collision n’écrase jamais votre modèle ; l’installation est refusée et demande un autre code.
• Actuellement, seul PDFgine publie. Les points de terminaison de publication et d’offre répondent 403 pour un espace sans rôle d’éditeur ; ne construisez donc pas encore de parcours vendeur dessus.
• Le curseur de liste contient les filtres. Modifier search, category ou locale en conservant before répond volontairement 400 ; le même curseur pointerait sinon vers une autre liste.
• Une mise en page payante s’installe uniquement après vérification du paiement. Appeler install avant checkout entraîne un refus, pas une mise en file.