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-12e14) via the API, please make a
POST request to
https://api.diecuttemplates.com/dieline-templates/becf-12e14/dielines
curl -i -X POST \
https://api.diecuttemplates.com/dieline-templates/becf-12e14/dielines\
-H "Content-Type: application/json" \
-H "Authorization: Bearer <YOUR_DIELINES_API_KEY_HERE>" \
-d '{
"format": "pdf",
"variables": {
"unit": "in",
"material": 0.4826,
"length": 7.0,
"width": 4.0,
"height": 3.0
}
}'
require 'uri'
require 'net/http'
require 'openssl'
url = URI('https://api.diecuttemplates.com/dieline-templates/becf-12e14/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-12e14/dielines';
$data = [
"format" => "pdf",
"variables" => [
"unit" => "in",
"material" => "0.4826",
"length" => "7.0",
"width" => "4.0",
"height" => "3.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"
},
"created_at": "2024-12-18T19:27:22Z"
}
}
Variable name | length required |
Description | length |
Data type | length |
Variable name | width required |
Description | width |
Data type | length |
Variable name | height required |
Description | height |
Data type | length |
Variable name | overflow optional |
Description | overflow |
Data type | boolean |
Default value | false |
Allowed values | true, false, 0, 1 |
Variable name | overflow_margin optional |
Description | overflow margin |
Data type | length |
Default value | 0.0 in |
Variable name | glue_margin optional |
Description | glue margin |
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 | cross optional |
Description | cross |
Data type | boolean |
Default value | false |
Allowed values | true, false, 0, 1 |
Variable name | window_length optional |
Description | window length |
Data type | length |
Default value | 3.5 in |
Variable name | window_height optional |
Description | window height |
Data type | length |
Default value | 2.0 in |
Variable name | display_length optional |
Description | display length |
Data type | length |
Default value | 2.8 in |
Variable name | display_height optional |
Description | display height |
Data type | length |
Default value | 2.6025 in |
Variable name | thumb_cut optional |
Description | thumb cut |
Data type | length |
Default value | 0.67 in |
Variable name | glue_flap optional |
Description | glue flap |
Data type | length |
Default value | 0.6 in |
Variable name | top_tuck_flap optional |
Description | top tuck flap |
Data type | length |
Default value | 0.6 in |
Variable name | dust_flap optional |
Description | dust flap |
Data type | length |
Default value | 1.0 in |
Variable name | bottom_tuck_flap optional |
Description | bottom tuck flap |
Data type | length |
Default value | 0.6667 in |
Variable name | dimension_texts optional |
Description | |
Data type | boolean |
Default value | true |
Allowed values | true, false |