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
Einzelheiten
In vier Schritten
- Schlüssel im Konto erzeugen: Er erscheint genau einmal.
- Dateien schicken: bis zu 20 je Auftrag, Einstellungen als JSON.
POST /v1/jobs - Zusehen über den Ereignisstrom oder den Auftrag abfragen.
GET /v1/jobs/{job_id}/events - 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. |
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.
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.