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
In detail
In four steps
- Create a key in the account: the key shows exactly once.
- Send the files: up to 20 per job, settings as JSON.
POST /v1/jobs - Watch the event stream or poll the job.
GET /v1/jobs/{job_id}/events - 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. |
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.
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.