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-1210b) via the API, please make a
POST request to
https://api.diecuttemplates.com/dieline-templates/becf-1210b/dielines
curl -i -X POST \
https://api.diecuttemplates.com/dieline-templates/becf-1210b/dielines\
-H "Content-Type: application/json" \
-H "Authorization: Bearer <YOUR_DIELINES_API_KEY_HERE>" \
-d '{
"format": "pdf",
"variables": {
"unit": "in",
"material": 0.4826,
"length": 6.0,
"width": 2.5,
"height": 6.5
}
}'
require 'uri'
require 'net/http'
require 'openssl'
url = URI('https://api.diecuttemplates.com/dieline-templates/becf-1210b/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-1210b/dielines';
$data = [
"format" => "pdf",
"variables" => [
"unit" => "in",
"material" => "0.4826",
"length" => "6.0",
"width" => "2.5",
"height" => "6.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 | 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 | 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 | hand_holding_width optional |
Description | hand holding width |
Data type | length |
Default value | 1.0 in |
Variable name | cover_flap optional |
Description | cover flap |
Data type | length |
Default value | 2.363 in |
Variable name | cover_tuck_flap optional |
Description | cover tuck flap |
Data type | length |
Default value | 1.17 in |
Variable name | lock_margin optional |
Description | lock margin |
Data type | length |
Default value | 0.5908 in |
Variable name | corner_radius_1 optional |
Description | corner radius |
Data type | length |
Default value | 0.2 in |
Variable name | corner_radius_2 optional |
Description | corner radius |
Data type | length |
Default value | 0.395 in |
Variable name | corner_radius_3 optional |
Description | corner radius |
Data type | length |
Default value | 0.395 in |
Variable name | hand_holding_length optional |
Description | hand holding length |
Data type | length |
Default value | 3.543 in |
Variable name | hand_holding_margin optional |
Description | hand holding margin |
Data type | length |
Default value | 0.6815 in |
Variable name | glue_flap optional |
Description | glue flap |
Data type | length |
Default value | 0.5 in |
Variable name | bottom_glue optional |
Description | bottom glue |
Data type | length |
Default value | 0.5 in |
Variable name | dimension_texts optional |
Description | |
Data type | boolean |
Default value | true |
Allowed values | true, false |