A drawing API for your own software

The same engine as the website, called from your own software.

One request, one answer

Both examples are real: a check sends the request to the running service and compares the answer.

The request

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

The answer

{
  "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"}
  ]
}

Full reference: to try out · to read · OpenAPI document

See jobs in the browser

In detail

In four steps
  1. Create a key in the account: the key shows exactly once.
  2. Send the files: up to 20 per job, settings as JSON. POST /v1/jobs
  3. Watch the event stream or poll the job. GET /v1/jobs/{job_id}/events
  4. Fetch the files as a ZIP: only the fetch is paid for. GET /v1/jobs/{job_id}/files
Sign-in

Two equal headers; an invalid key gives 401, never an anonymous request.

What you send Meaning
X-API-Key: abk_... The usual way; the key's jobs belong to your account.
Authorization: Bearer abk_... The same key, for HTTP clients sending bearer tokens.
(no key) Allowed: drawn with previews, but with no archive to fetch; deleted after 2 hours.

Manage keys in your account

Status codes

Every refusal gives its reason in the body, checked on the running service.

Code Meaning
401 Key missing, unknown or revoked.
402 Not paid; the answer gives the price and the link to order.
403 API switched off, or another account's job.
404 Job unknown or already deleted.
409 Stopping or changing is no longer possible.
413 Too large or too many files; “Limits” gives the limits.
422 Settings do not fit the schema; the body names the setting and the reason.
429 Too many requests.
Limits
  • Up to 20 files per job.
  • Up to 50 MB per file.
  • Up to 200 MB per job in total; the formats read are .stp,.step,.ifc,.3dm,.dae.
  • A download waits until its job is paid; without an order nothing is charged.
  • At most 120 calls per key and minute; a call beyond the limit is refused with Retry-After.
  • At most 10 jobs per account in progress at once, and up to 1000 parts per job.
  • Storage: 7 days with an account, 2 hours without; then everything is deleted.
Version

The version is in the path (/v1); within a version, schema fields (draw-settings/1) are only added, with the old result as default. Nothing is renamed, redefined or removed; anything breaking an integration would come at a new address.

When a version ends, the new one runs at its own address alongside the old one.

View the schema

Check notice

Every drawing carries the printed check notice, including drawings delivered to your customers: Alle Maße vor der Fertigung durch eine fachkundige Person prüfen.

Only someone declaring the drawings checked may omit the notice, per job; each answer is recorded with time and wording. For an omission, send the job with file_production: on_request and request the files with POST /v1/jobs/{id}/files.

Customer duties

Obtain the declaration from your own customer after the customer has seen the drawings: GET /v1/jobs/{id}/parts/{n}/preview.png shows every preview before any charge. Pass on the check duty with the same choice per job, and record the customer's decision. You confirm these duties once in the account; without the confirmation the API refuses the request. Confirm the duties in your account

Cost

The API costs the same as the website: per job, for the different parts you download. A part costs €0.60 to €1.07 including VAT, with a minimum per payment; the answer gives price and order link. See the prices

A request without a key returns the free preview: every part is drawn, without charge. Only downloading the files is paid for, and an anonymous job has no archive.

Sales area

This service is sold in the European Union, the European Economic Area, the United Kingdom and Switzerland. It is not sold to businesses whose place of business is in the United States or Canada.

Pass the sales area on to your own customers, as you pass on the check duty.

Result

One dimensioned sheet per part, in the requested formats DXF, PDF or SVG. Collected files per uploaded file from two parts, and for the job from two files; all in one ZIP.

The event stream reports every finished part at once; polling returns the same state document.

The API runs on the website's engine: with the same settings, the sheet is identical line for line.

Try it now, free

Upload a CAD file and see the dimensioned preview at once, free, with no account; you pay only on download.

Upload a file and try it

Account