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-30109) via the API, please make a
POST request to
https://api.diecuttemplates.com/dieline-templates/becf-30109/dielines
curl -i -X POST \
https://api.diecuttemplates.com/dieline-templates/becf-30109/dielines\
-H "Content-Type: application/json" \
-H "Authorization: Bearer <YOUR_DIELINES_API_KEY_HERE>" \
-d '{
"format": "pdf",
"variables": {
"unit": "in",
"material": 1.1938,
"lenght": 4.0,
"width": 3.5,
"bottom_height": 1.0,
"inside_receptacle": 2.0,
"cover_height": 3.5
}
}'
require 'uri'
require 'net/http'
require 'openssl'
url = URI('https://api.diecuttemplates.com/dieline-templates/becf-30109/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-30109/dielines';
$data = [
"format" => "pdf",
"variables" => [
"unit" => "in",
"material" => "1.1938",
"lenght" => "4.0",
"width" => "3.5",
"bottom_height" => "1.0",
"inside_receptacle" => "2.0",
"cover_height" => "3.5"
]
];
$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 | lenght required |
Description | lenght |
Data type | length |
Variable name | width required |
Description | width |
Data type | length |
Variable name | bottom_height required |
Description | bottom height |
Data type | length |
Variable name | inside_receptacle required |
Description | inside receptacle |
Data type | length |
Variable name | cover_height required |
Description | cover height |
Data type | length |
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 | top_flap optional |
Description | top flap |
Data type | length |
Default value | 0.788 in |
Variable name | top_side_flap optional |
Description | top side flap |
Data type | length |
Default value | 0.788 in |
Variable name | top_inside_margin optional |
Description | top inside margin |
Data type | length |
Default value | 0.1575 in |
Variable name | bottom_flap optional |
Description | bottom flap |
Data type | length |
Default value | 0.788 in |
Variable name | bottom_side_flap optional |
Description | bottom side flap |
Data type | length |
Default value | 0.788 in |
Variable name | bottom_inside_margin optional |
Description | bottom inside margin |
Data type | length |
Default value | 0.1575 in |
Variable name | inside_flap optional |
Description | inside flap |
Data type | length |
Default value | 0.788 in |
Variable name | inside_side_flap optional |
Description | inside side flap |
Data type | length |
Default value | 0.788 in |
Variable name | inside_flap_margin optional |
Description | inside flap margin |
Data type | length |
Default value | 0.1575 in |
Variable name | dimension_texts optional |
Description | |
Data type | boolean |
Default value | true |
Allowed values | true, false |