Eine Zeichnungs-API für Ihre eigene Software

Dieselbe Maschine wie die Website, aufgerufen aus Ihrer eigenen Software.

Eine Anfrage, eine Antwort

Beide Beispiele sind echt: Eine Prüfung schickt die Anfrage an den laufenden Dienst und vergleicht die Antwort.

Die Anfrage

curl -X POST https://slatlyn.com/v1/jobs \
  -H "X-API-Key: abk_..." \
  -F "file=@beam.stp" \
  -F 'settings={"output_format": "both"}'

Die Antwort

{
  "id": "1f0c9a4d5e6b47c8a9d0e1f2a3b4c5d6",
  "status": "pending",
  "schema": "draw-settings/1",
  "owner": "account",
  "retention": "7 days",
  "events": "/v1/jobs/1f0c9a4d5e6b47c8a9d0e1f2a3b4c5d6/events",
  "files": [
    {"n": 1, "filename": "beam.stp", "status": "pending"}
  ]
}

Vollständige Referenz: zum Ausprobieren · zum Lesen · OpenAPI-Dokument

Aufträge im Browser sehen

Einzelheiten

In vier Schritten
  1. Schlüssel im Konto erzeugen: Er erscheint genau einmal.
  2. Dateien schicken: bis zu 20 je Auftrag, Einstellungen als JSON. POST /v1/jobs
  3. Zusehen über den Ereignisstrom oder den Auftrag abfragen. GET /v1/jobs/{job_id}/events
  4. Dateien als ZIP abholen: Erst der Abruf wird bezahlt. GET /v1/jobs/{job_id}/files
Anmeldung

Zwei gleichwertige Kopfzeilen; ein ungültiger Schlüssel ergibt 401, nie eine anonyme Anfrage.

Was Sie senden Bedeutung
X-API-Key: abk_... Der übliche Weg; Aufträge des Schlüssels gehören Ihrem Konto.
Authorization: Bearer abk_... Derselbe Schlüssel für HTTP-Clients, die Bearer-Token senden.
(no key) Erlaubt: Gezeichnet wird mit Vorschauen, aber ohne Archiv zum Abholen; gelöscht nach 2 Stunden.

Schlüssel im Konto verwalten

Statuscodes

Jede Absage nennt ihren Grund im Rumpf, geprüft am laufenden Dienst.

Code Bedeutung
401 Schlüssel fehlt, ist unbekannt oder widerrufen.
402 Nicht bezahlt; die Antwort nennt Preis und den Link zum Bestellen.
403 API abgeschaltet oder fremder Auftrag.
404 Auftrag unbekannt oder schon gelöscht.
409 Abbrechen oder Ändern ist nicht mehr möglich.
413 Zu groß oder zu viele Dateien; die Grenzen nennt „Grenzen“.
422 Einstellungen passen nicht zum Schema; der Rumpf nennt Schemafeld und Grund.
429 Zu viele Anfragen; Retry-After nennt die Wartezeit.
Grenzen
  • Bis zu 20 Dateien je Auftrag.
  • Bis zu 50 MB je Datei.
  • Bis zu 200 MB je Auftrag insgesamt; gelesen werden .stp,.step,.ifc,.3dm,.dae.
  • Ein Download wartet, bis sein Auftrag bezahlt ist; ohne Bestellung wird nichts berechnet.
  • Höchstens 120 Aufrufe je Schlüssel und Minute; ein Aufruf über der Grenze wird mit Retry-After abgewiesen.
  • Höchstens 10 Aufträge je Konto gleichzeitig in Arbeit und bis zu 1000 Bauteile je Auftrag.
  • Aufbewahrung: 7 Tage mit Konto, 2 Stunden ohne; danach ist alles gelöscht.
Version

Die Version steht im Pfad (/v1); innerhalb einer Version kommen Felder des Einstellungsschemas (draw-settings/1) nur hinzu, mit dem bisherigen Ergebnis als Standard. Nichts wird umbenannt, umgedeutet oder entfernt; was eine Integration bräche, käme unter einer neuen Adresse.

Endet eine Version, läuft die neue unter eigener Adresse neben der alten.

Schema ansehen

Prüfhinweis

Jede Zeichnung trägt den gedruckten Prüfhinweis, auch an Ihre Kunden ausgelieferte: Alle Maße vor der Fertigung durch eine fachkundige Person prüfen.

Weglassen darf ihn je Auftrag nur, wer die Prüfung der Zeichnungen erklärt; jede Antwort wird mit Zeit und Wortlaut festgehalten. Dafür den Auftrag mit file_production: on_request senden und die Dateien mit POST /v1/jobs/{id}/files anfordern.

Pflichten gegenüber Kunden

Holen Sie die Erklärung bei Ihrem eigenen Kunden ein, nachdem er die Zeichnungen sah: GET /v1/jobs/{id}/parts/{n}/preview.png zeigt jede Vorschau vor der Berechnung. Geben Sie die Prüfpflicht mit derselben Wahl je Auftrag weiter und halten Sie seine Entscheidung fest. Diese Pflichten bestätigen Sie einmal im Konto; ohne Bestätigung lehnt die API die Anfrage ab. Die Pflichten im Konto bestätigen

Kosten

Die API kostet dasselbe wie die Website: je Auftrag, für die verschiedenen Bauteile, die Sie herunterladen. Ein Bauteil kostet 0,60 € bis 1,07 € einschließlich Umsatzsteuer, mit Mindestbetrag je Zahlung; die Antwort nennt Preis und Link zum Bestellen. Zu den Preisen

Eine Anfrage ohne Schlüssel liefert die kostenlose Vorschau: Gezeichnet wird jedes Bauteil, ohne Berechnung. Bezahlt wird erst der Download der Dateien, und ein anonymer Auftrag hat kein Archiv.

Vertriebsgebiet

Dieser Dienst wird in der Europäischen Union, im Europäischen Wirtschaftsraum, im Vereinigten Königreich und in der Schweiz verkauft. An Unternehmen mit Sitz in den Vereinigten Staaten oder in Kanada wird er nicht verkauft.

Geben Sie das Vertriebsgebiet an Ihre eigenen Kunden weiter, wie die Prüfpflicht.

Ergebnis

Ein bemaßtes Blatt je Bauteil, in den angeforderten Formaten DXF, PDF oder SVG. Sammeldateien je hochgeladener Datei ab zwei Bauteilen und für den Auftrag ab zwei Dateien; alles in einem ZIP.

Der Ereignisstrom meldet jedes fertige Bauteil sofort; wer lieber abfragt, bekommt dasselbe Zustandsdokument.

Hinter der API steht dieselbe Maschine wie hinter der Website: Bei gleichen Einstellungen ist das Blatt Strich für Strich dasselbe.

Jetzt kostenlos ausprobieren

Eine CAD-Datei hochladen und die bemaßte Vorschau sofort sehen, kostenlos und ohne Konto; bezahlt wird erst der Download.

Datei hochladen und ausprobieren

Konto