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-30203) via the API, please make a
POST request to
https://api.diecuttemplates.com/dieline-templates/becf-30203/dielines
curl -i -X POST \
https://api.diecuttemplates.com/dieline-templates/becf-30203/dielines\
-H "Content-Type: application/json" \
-H "Authorization: Bearer <YOUR_DIELINES_API_KEY_HERE>" \
-d '{
"format": "pdf",
"variables": {
"unit": "in",
"material": 1.2954,
"length": 8.0,
"width": 4.0,
"height": 2.0
}
}'
require 'uri'
require 'net/http'
require 'openssl'
url = URI('https://api.diecuttemplates.com/dieline-templates/becf-30203/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-30203/dielines';
$data = [
"format" => "pdf",
"variables" => [
"unit" => "in",
"material" => "1.2954",
"length" => "8.0",
"width" => "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"
},
"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 | front_flap optional |
Description | front flap |
Data type | length |
Default value | 1.9685 in |
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 | number_of_magnets optional |
Description | number of magnets |
Data type | integer |
Default value | 2 |
Allowed values | 1, 2, 3 |
Variable name | magnet_diameter optional |
Description | magnet diameter |
Data type | length |
Default value | 0.395 in |
Variable name | magnet_distance optional |
Description | magnet distance |
Data type | length |
Default value | 1.0145 in |
Variable name | bottom_inside_flap_1 optional |
Description | bottom inside flap |
Data type | length |
Default value | 0.788 in |
Variable name | inside_side_margin optional |
Description | inside side margin |
Data type | length |
Default value | 0.1575 in |
Variable name | bottom_side_flap optional |
Description | bottom side flap |
Data type | length |
Default value | 0.788 in |
Variable name | bottom_inside_flap_2 optional |
Description | bottom inside flap |
Data type | length |
Default value | 0.788 in |
Variable name | number_of_cover_pieces optional |
Description | number of cover pieces |
Data type | integer |
Default value | 4 |
Allowed values | 3, 4 |
Variable name | cover_has_magnet optional |
Description | cover has magnet ? |
Data type | boolean |
Default value | true |
Allowed values | true, false, 0, 1 |
Variable name | cover_corner_angle optional |
Description | cover corner angle |
Data type | angle |
Default value | 20 |
Allowed values | 20.0, 25.0, 30.0, 35.0, 40.0, 45.0 |
Variable name | cover_side_flap_1 optional |
Description | cover side flap |
Data type | length |
Default value | 0.788 in |
Variable name | cover_side_flap_2 optional |
Description | cover side flap |
Data type | length |
Default value | 0.788 in |
Variable name | dimension_texts optional |
Description | |
Data type | boolean |
Default value | true |
Allowed values | true, false |