Produkt- und API-Leitfaden

Marktplatzvorlagen

Was fertige Designs bieten

Der Marktplatz bietet von PDFgine gestaltete Ausgangspunkte für Angebote, Berichte, Präsentationen und ähnliche Dokumente. Nach dem Hinzufügen zum Arbeitsbereich können Sie Text, Daten, Farben und Layout im Generator bearbeiten.

Derzeit veröffentlicht nur PDFgine Vorlagen auf dem Marktplatz. Für Kunden gibt es keinen Ablauf zum Verkauf eigener Vorlagen.

Zugriffsarten

  • Kostenlos: Benutzer mit der erforderlichen Berechtigung können die Vorlage direkt zum Arbeitsbereich hinzufügen.
  • Im Tarif enthalten: Es fallen keine Zusatzkosten an, wenn Ihr aktiver Tarif die Vorlage umfasst.
  • Kostenpflichtig: Nach bestätigter Einmalzahlung kann die Vorlage im entsprechenden Arbeitsbereich installiert werden.

Vorlage beziehen und verwenden

  1. Suchen Sie ein Design nach Kategorie oder Suchbegriff und prüfen Sie Titelseite und Beschreibung.
  2. Fügen Sie eine kostenlose oder im Tarif enthaltene Vorlage hinzu oder bezahlen Sie ein kostenpflichtiges Design über den sicheren Bezahlvorgang.
  3. Die Installation fügt dem Vorlagenbereich des ausgewählten Arbeitsbereichs eine bearbeitbare Kopie hinzu.
  4. Öffnen Sie die Vorlage im Generator, ersetzen Sie Beispieldaten durch eigene Daten und prüfen Sie PDF, Word und Viewer vor der Veröffentlichung.

Der Vorlagencode muss im Arbeitsbereich eindeutig sein. Eine Kollision überschreibt keine vorhandene Vorlage; Sie werden zur Wahl eines anderen Codes aufgefordert.

Über die API veröffentlichen und installieren

Alles, was die Marktplatzseite kann, ist auch als Endpunkt verfügbar: veröffentlichte Angebote auflisten, eine Vorlage in Ihr Konto kopieren, eine eigene veröffentlichen und ihren Preis festlegen.

cURL 
# Veröffentlichte Angebote auflisten
curl -s "https://api.pdfgine.com/api/v1/marketplace/templates?locale=en" \
  -H "X-PDFgine-Key: $PDFGINE_KEY"

# Eine Vorlage in Ihr eigenes Konto kopieren
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": "Angebot" }'

# Eine eigene Vorlage veröffentlichen
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": "Rechnung mit Zahlungsbedingungen",
        "summary": "Eine Rechnungsvorlage mit Zahlungsbedingungen und Summenblock.",
        "category": "reports",
        "locale": "en",
        "license": "commercial",
        "visibility": "public",
        "confirmAssetRedistributionRights": true
      }'

# Preis festlegen - priceMinorUnits ist erforderlich, wenn isFree false ist
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
      }'

Bei der Installation wird die Vorlage in Ihr Konto kopiert; spätere Änderungen des Herausgebers wirken sich nicht auf Ihre Kopie aus. Bei der Veröffentlichung bestätigen Sie, dass Sie die enthaltenen Schriften und Bilder weitergeben dürfen. Diese Bestätigung wird gespeichert.

Eigene Diagramme und Vorlagen

Für eigene Vorlagen oder Diagramme ist kein Marktplatzkauf erforderlich. Verkauft wird das von PDFgine vorbereitete fertige Design.

Marktplatz öffnen →

Häufige Fehler

  • Die Installation kopiert das Design in Ihren Arbeitsbereich. Spätere Änderungen des Herausgebers erreichen diese Kopie nicht; Ihre Bearbeitungen werden ebenfalls nie überschrieben.
  • Der Code muss in Ihrem Arbeitsbereich frei sein. Bei einer Kollision wird Ihre Vorlage nie überschrieben; die Installation wird abgelehnt und verlangt einen anderen Code.
  • Derzeit veröffentlicht nur PDFgine. Endpunkte für Veröffentlichung und Angebote antworten bei Arbeitsbereichen ohne Herausgeberrolle mit 403. Bauen Sie darauf daher noch keinen Verkaufsablauf auf.
  • Der Listencursor enthält die Filter. Änderungen an Suche, Kategorie oder Sprache bei unverändertem before liefern bewusst 400, da der Cursor sonst auf eine andere Liste zeigen würde.
  • Ein kostenpflichtiges Design wird erst nach bestätigter Zahlung installiert. Wer install vor checkout aufruft, erhält eine Ablehnung statt eines Warteschlangeneintrags.