Produkt- und API-Leitfaden

Integrationen für Make und Zapier

Vor dem Verbinden

Sie benötigen ein PDFgine-Kundenkonto, eine Vorlage in diesem Arbeitsbereich, verfügbares Seitenkontingent und ein Make- oder Zapier-Konto. Erstellen Sie zuerst Ihre Vorlage und notieren Sie deren Template Code.

Die Make-App wird derzeit für den Katalog geprüft. Die Zapier-Integration ist privat. Wenden Sie sich für den Zugang an PDFgine; beide Integrationen sind noch nicht öffentlich gelistet.

Integrationszugang anfragen

Arbeitsbereich verbinden

Erstellen Sie in Ihrem PDFgine-Konto einen eigenen API-Schlüssel mit usage:read und documents:render. Verwenden Sie die unten angegebene gehostete API-URL. Ergänzen Sie templates:read nur, wenn Sie die optionale Brand Kit-Auswahl für Vorschauen verwenden.

https://api.pdfgine.com · usage:read · documents:render

Die Locale-Auswahl des Connectors bietet derzeit Englisch und Türkisch. Die Sprache der Website ändert weder die Dokumentdaten noch die verfügbaren Felder des Connectors.

Make-Szenario einrichten

  1. Nehmen Sie den von PDFgine bereitgestellten Zugang zur privaten App an. Fügen Sie Ihrem Szenario ein PDFgine-Modul hinzu und erstellen Sie eine Verbindung mit Ihrer API-URL und einem eigenen API-Schlüssel.
  2. Wählen Sie Create a Document, legen Sie Template Code und Format fest und ordnen Sie die Werte des vorherigen Moduls dem JSON-Objekt Template Data zu. Verwenden Sie Queue a Document für asynchrone Verarbeitung oder Create a Public Preview für einen Link für Empfänger.
  3. Führen Sie Run once mit Beispieldaten aus und prüfen Sie das Modulergebnis und das erzeugte Dokument. Aktivieren Sie die Zeitplanung erst, wenn die Zuordnung stimmt. Make an API call unterstützt autorisierte relative API-Pfade; die Berechtigungsbereiche der Verbindung gelten weiterhin.

Zap einrichten

  1. Nehmen Sie die Einladung zur privaten PDFgine-Integration in Ihrem Zapier-Konto an. Wählen Sie den Auslöser, fügen Sie eine PDFgine-Aktion hinzu und verbinden Sie sich mit Ihrer API-URL und einem eigenen API-Schlüssel.
  2. Legen Sie für Create Document die Felder Template Code und Format fest und ordnen Sie Auslöserdaten als gültiges JSON dem Feld Template Data zu. Queue Document und Create Public Preview sind separate Aktionen. Brand Kits ist eine optionale Datenquelle für eine Auswahlliste, kein Auslöser.
  3. Testen Sie die Aktion, veröffentlichen Sie den Zap und senden Sie ein neues Auslöserereignis. Prüfen Sie den erfolgreichen Lauf in Zap History und das Dokument dieses Ereignisses; ein Test Step im Editor allein belegt nicht, dass der aktive Ablauf ausgeführt wurde.

Echte Werte zuordnen und gültiges JSON beibehalten

Template Data muss ein JSON-Objekt sein, das den Feldern Ihrer Vorlage entspricht, kein Dateipfad und kein leerer Platzhalter. Das folgende Beispiel gilt für eine Angebotsvorlage. Ordnen Sie Namen und Beträge aus Ihrem Auslöser zu, belassen Sie numerische Werte als Zahlen und prüfen Sie berechnete Summen vor dem Senden.

JSON 
{
  "document": { "title": "DEMO ONLY" },
  "referenceNo": "DEMO-001",
  "issueDate": "2026-10-27",
  "currency": "USD",
  "customer": "Demo Customer",
  "quoteItems": [
    { "name": "Demo service", "quantity": 2, "unitPrice": 50, "total": 100 }
  ],
  "subtotal": 100,
  "vatAmount": 20,
  "grandTotal": 120
}

Passende Ausgabe wählen

Create Document liefert eine geschützte downloadUrl, die API-Authentifizierung erfordert. Verwenden Sie für einen im Browser zugänglichen Kundenlink Create Public Preview und wählen Sie eine erlaubte Zugriffsdauer. Queue Document liefert eine statusUrl für den Auftrag; eine Antwort mit Warteschlangenstatus ist noch kein fertiges Dokument.

Erstellung über die Warteschlange · Vorschaulinks

Vor dem Aktivieren testen

Verwenden Sie zunächst fiktive Kundendaten. Prüfen Sie Empfänger, Referenz, Positionen, Summen und Ausgabeformat. Senden Sie nach dem Aktivieren ein neues Ereignis und prüfen Sie den Ausführungsverlauf der Plattform. Vermeiden Sie wiederholte Produktionsläufe: Erzeugte Seiten verbrauchen Ihr PDFgine-Kontingent.

Grenzen und Fehlerbehebung

Prüfen Sie bei 401 oder 403 die Verbindung und API-Berechtigungsbereiche. Prüfen Sie bei 402 das verfügbare Kontingent. Beachten Sie bei 429 Retry-After und reduzieren Sie die Anfragehäufigkeit. Korrigieren Sie ungültiges JSON oder Vorlagendaten vor einem erneuten Versuch. Vorschaudauer und Generierungsgrenzen hängen von Ihrem Tarif ab.

Fehler · Kontingent abfragen

Verbindungsschlüssel geheim halten

Geben Sie Ihren API-Schlüssel ausschließlich in den Verbindungseinstellungen der Plattform ein. Tragen Sie ihn nicht in Template Data, Screenshots oder geteilte Ausführungsprotokolle ein. Verwenden Sie für jede Verbindung einen eigenen Schlüssel und widerrufen Sie ihn in PDFgine, wenn der Zugang nicht mehr benötigt wird.

Benötigen Sie Dokumentereignisse? Lesen Sie die API-Webhook-Anleitung. Webhooks