This documentation page is intended for developers looking to integrate the Dielines API into their systems. If you have any questions, please get in touch.
Die Cut Templates provides a hosted API available via HTTPS.
Dielines API allows for generating custom dielines in PDF, DXF, and SVG formats, along with 3D mockups.
To create custom dieline using the dieline template (becf-21709) via the API, please make a
POST request to
https://api.diecuttemplates.com/dieline-templates/becf-21709/dielines
curl -i -X POST \
https://api.diecuttemplates.com/dieline-templates/becf-21709/dielines\
-H "Content-Type: application/json" \
-H "Authorization: Bearer <YOUR_DIELINES_API_KEY_HERE>" \
-d '{
"format": "pdf",
"variables": {
"unit": "in",
"material": 1.1906,
"width_1": 6.5,
"width_2": 4.0,
"height": 2.0
}
}'
require 'uri'
require 'net/http'
require 'openssl'
url = URI('https://api.diecuttemplates.com/dieline-templates/becf-21709/dielines')
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request['Content-Type'] = 'application/json'
request['Dielines-Api-Version'] = '1.0'
request['Authorization'] = 'Bearer <YOUR_DIELINES_API_KEY_HERE>'
params = {
"format": "pdf",
"variables": {
"unit": "in",
"material": 0.11,
"length": 4.25,
"width": 3.00,
"height": 5.00,
"top_tuck_flap": 0.53
}
}
request.body = params.to_json
response = http.request(request)
puts response.read_body
$url = 'https://api.diecuttemplates.com/dieline-templates/becf-21709/dielines';
$data = [
"format" => "pdf",
"variables" => [
"unit" => "in",
"material" => "1.1906",
"width_1" => "6.5",
"width_2" => "4.0",
"height" => "2.0"
]
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer <YOUR_DIELINES_API_KEY_HERE>'
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
$response = curl_exec($ch);
if (curl_errno($ch)) {
echo 'Error: ' . curl_error($ch);
} else {
echo 'Response: ' . $response;
}
curl_close($ch);
application/json
{
"dieline": {
"type": "dieline",
"id": "ueipnpyp0rlw",
"dieline_template_id": "becf-10301",
"variables": {
"unit": "mm",
"length": 251.13,
"width": 102,
"height": 253,
"material": 2.22
},
"format": "pdf",
"url": "https://d2atdwxjx7uc4i.cloudfront.net/campaigns/0e9d742f-bdcd-4b41-8122-88e0426d263f20241218-14172-y29ocn.pdf",
"artwork_dimensions": {
"unit": "mm",
"width": "723.06",
"height": "502.44"
},
"area": {
"unit": "mm2",
"value": "11723.06"
},
"created_at": "2024-12-18T19:27:22Z"
}
}
Variable name | dimension_type optional |
Description | |
Data type | string |
Default value | external |
Allowed values | external, internal |
Variable name | width_1 required |
Description | width |
Data type | length |
Variable name | width_2 required |
Description | width |
Data type | length |
Variable name | height required |
Description | height |
Data type | length |
Variable name | u_bent optional |
Description | u bent |
Data type | boolean |
Default value | false |
Allowed values | true, false, 0, 1 |
Variable name | cross optional |
Description | cross |
Data type | boolean |
Default value | false |
Allowed values | true, false, 0, 1 |
Variable name | direction optional |
Description | direction |
Data type | boolean |
Default value | false |
Allowed values | true, false, 0, 1 |
Variable name | postal_lock_length optional |
Description | postal lock length |
Data type | length |
Default value | 2.0 in |
Variable name | postal_lock_width optional |
Description | postal lock width |
Data type | length |
Default value | 0.788 in |
Variable name | dust_flap optional |
Description | dust flap |
Data type | length |
Default value | 2.0 in |
Variable name | handle_width optional |
Description | handle width |
Data type | length |
Default value | 1.0 in |
Variable name | handle_length optional |
Description | handle length |
Data type | length |
Default value | 4.53 in |
Variable name | slot_width optional |
Description | slot width |
Data type | length |
Default value | 0.6 in |
Variable name | slot_spacing optional |
Description | slot spacing |
Data type | length |
Default value | 4.15 in |
Variable name | slot_length optional |
Description | slot length |
Data type | length |
Default value | 0.2 in |
Variable name | printing_method optional |
Description | Offset (material is squeezed) or Flexo (material is not squeezed) |
Data type | string |
Default value | offset |
Allowed values | offset, flexo |
Variable name | dimension_texts optional |
Description | |
Data type | boolean |
Default value | true |
Allowed values | true, false |