Hard Cardboards | Boxes With Hinged Lid | becf-30203
3D Mockup

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


Code Examples



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);

Example Response

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"
  }
} 



List of variables that are available for the template

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



Read Dielines API documentation