Products

The Products call allows you to easy and dynamically query our database of products to present options to your customer. You can either do this on demand or periodically, it will always return the full catalog of products offered based on your credentials.

GET /products

Content-type: application/json

curl

Example Request
1
2
3
4
curl https://prospector.dragdrop.design/api/v1/products \
	-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.r3udhowqndkwqneoiqwndjwndei12u390912hrbfhaslkdjbqwiei21nbrhewiuornqwjkfhbaiwodnqwjkbdawuosdhowqubdfjkwbdusandbiwquebio12nedbwbaodpqwnebou12rbwkjalndawuobdnwqndfqwbdfoiwqndpiqwhfiwqnkjdlnwqdnioqwhniorqw3nfjwbaodnwdnqwopd" \
	-H "Accept: application/json" \
	-H "Content-Type: application/json"
Example Response
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
[
	{
		"_id": "benT9erT8BwHrn6Ws",
		"name": "5x7 Flat Card Horizontal",
		"editorCompatibility": "cardEditor",
		"category": {
			"id": "7sXPek95CQ6f6N5Hu",
			"name": "Press Printed Cards"
		},
		"metadata": {
			"width": 7,
			"height": 5,
			"bleed": 0.25,
			"resolution": 300
		},
		"nodes": [
			{
				"name": "Front",
				"nodeId": 10000,
				"height": 5.25,
				"width": 7.25,
				"x": 0,
				"y": 0
			},
			{
				"name": "Back",
				"nodeId": 10001,
				"height": 5.25,
				"width": 7.25,
				"x": 0,
				"y": 0
			}
		]
	},
	{
		"_id": "6aLYwjRKYk8XQ4MZk",
		"name": "Framed Print",
		"editorCompatibility": "simpleEditor",
		"category": {
			"id": "tfhysKwZafFtmGqpQ",
			"name": "Wall Displays"
		},
		"metadata": {
			"resolution": 300
		}
		"nodes": [
			{
				"name": "Main",
				"nodeId": 10000,
				"dimensionKeys": [
					"size"
				]
			}
		]
	},
	{
		"_id": "zqRtQT4NeWnoa9JPq",
		"name": "Album",
		"editorCompatibility": "albumEditor",
		"category": {
			"id": "2qNgr3zcSx9wvTAo9",
			"name": "Albums"
		},
		"metadata": {
			"resolution": 300,
			"cover_overhang": 0.125,
			"spread_bleed": 0.125
		},
		"nodes": [
			{
				"name": "Spread",
				"nodeId": 10000,
				"dimensionKeys": [
					"size"
				]
			}
		]
	}
]

The response object from this call returns JSON containing an array of products. The main piece of relevant data is the IDs of these items which can be used when creating an editor, but the additional data is returned to help you offer a complete selection experience on your end.





Product Level Elements

_id

string - 32

The ID of the product. You'll pass this in to create an editor of this product.

name

string - 255

The name of the product. This generally describes the product more specifically, and can generally be displayed to a customer who would potentially be ordering this product.

editorCompatibility

string - 255

The type of editor that'll be presented, we currently support cardEditor, simpleEditor, and albumEditor.

metadata

object

Contains additional metadata about this design, such as sizing information.

Show Children ▾

height

float - 4

the height of this node in inches.

width

float - 4

the width of this node in inches.

bleed

float - 4

the bleed amount this node in inches.

resolution

float - 4

the print resolution of this node is PPI.

nodes

object

The array contains the nodes of this product, items which can be filled with images, or designs (if offered).

Show Children ▾

name

string - 255

The name for this node.

nodeId

int - 8

The id for this node.

height

float - 4

the height of this node in inches.

width

float - 4

the width of this node in inches.

x

float - 4

the x position of this node in inches.

y

float - 4

the y position of this node in inches.

dimensionKeys

object

Only present for products which don't have a definitive. attribute size. If the size of the node is determined by an attribute in the editor this key specifies which attribute does the determining.

Back to Top 👆
Get in Touch

Interested in integrating with WHCC? Tell us more about what you’re looking for and we’ll be in touch.