Stanzkonturen aus Ihrer eigenen Software erzeugen

So funktioniert es

1. Vorlagen auflisten

   GET /api/v1/catalogue liefert jede aktive Vorlage mit öffentlichem Code, Namen und Parameternamen. Filtern mit q und category, blättern mit limit und cursor.

2. Das Schema einer Vorlage lesen

   GET /api/v1/catalogue/{code} liefert jeden Parameter mit Einheit, Standardwert, Schrittweite und Minimum-/Maximum-Regeln — auch Regeln, die von einem anderen Maß abhängen — dazu Optionen, Seiten und Formate.

3. Die Datei erzeugen

   POST /api/v1/dielines/{code} mit Format und Parametern. Der Antwortkörper ist die Datei selbst; Dateiname und Vorlagenversion stehen in den Headern.

Zugang und Schlüssel

Die Entwickler-API ist in den Paketen Bench, Workshop und Line enthalten. Schlüssel erstellen und widerrufen Sie unter Konto → Entwickler-API. Der vollständige Schlüssel wird nur einmal angezeigt; Packdroid speichert nur seinen Hash. Ein Konto kann fünf aktive Schlüssel haben.

Senden Sie den Schlüssel bei jeder Anfrage als Bearer-Token. Bewahren Sie ihn nur auf Ihrem Server auf, nie im Browser- oder App-Code, und widerrufen Sie ihn, falls er offengelegt wurde. Mit einem eigenen Schlüssel pro System lässt sich eine Integration stoppen, ohne die anderen zu beeinträchtigen.

Beispielanfrage

Vorlagen auflisten, dann die Parameter einer Vorlage lesen:

curl 'https://packdroid.com/api/v1/catalogue?limit=50' \
  --header 'Authorization: Bearer pd_live_your_secret'

curl 'https://packdroid.com/api/v1/catalogue/PD-TL02' \
  --header 'Authorization: Bearer pd_live_your_secret'

Eine FEFCO-0201-Faltkiste, 250 × 200 × 150 mm, aus 4-mm-Wellpappe, als SVG gespeichert:

curl --request POST \
  'https://packdroid.com/api/v1/dielines/FEFCO%200201' \
  --header 'Authorization: Bearer pd_live_your_secret' \
  --header 'Content-Type: application/json' \
  --output dieline.svg \
  --data '{"format":"svg","parameters":{"length":250,"width":200,"depth":150,"corrugated_thickness":4}}'

Was Sie zurückbekommen

SVG und PDF sind im physischen Maßstab 1:1 gezeichnet, Schnitt- und Rilllinien liegen auf getrennten Ebenen. Bemaßung oder das Infofeld fügen Sie mit den Feldern dimensions und info hinzu. Für CAD und Schneidetische gibt es DXF.

Mehrseitige Vorlagen (etwa Pappe und Bezug einer Hartkartonage) kommen als ein PDF, als ZIP mit DXF-Dateien oder als SVG — zusammengefasst oder in einzelne Bogen getrennt. Die Einheiten folgen der Vorlage: die meisten Maße in Millimetern, manche Materialstärken in Mikrometern.

Limits

Jede erfolgreich erzeugte Datei zählt zu den monatlichen Downloads des Pakets. Daneben hat jedes Paket Betriebslimits, die den Dienst schützen; Antworten tragen X-RateLimit-Header und bei 429 einen Retry-After.

Jeder Schlüssel führt höchstens zwei Renderings gleichzeitig aus, und ein Rendering bricht nach 30 Sekunden ab. Ein Schlüssel, der seine Limits wiederholt überschreitet, wird 15 Minuten gesperrt; ungültige Anfragen werden abgelehnt, bevor sie auf das Monatskontingent angerechnet werden.

Fehler

Fehler sind JSON mit einem stabilen code. Validierungsfehler nennen jedes Problem mit seiner Position, etwa parameters.length, und dem verletzten Minimum oder Maximum.

Loslegen

Wählen Sie ein kostenpflichtiges Paket und erstellen Sie dann unter Konto → Entwickler-API einen Schlüssel. Fragen zu einer Integration? Schreiben Sie uns.

Pakete ansehen API-Schlüssel erstellen Kontakt