Appearance
Get products
Returns a list of all the products which can be ordered using the API. The request might take some time since it will return all the products at once. Cache the results of the request if you need it often. Because of the sheer quantity of products we added segmentation. You can get the segments for photoframes and photobooks with the designated "filter" query params.
Endpoint
| Key | Value |
|---|---|
| URL | https://api.profotonet.nl/v1/products |
| Method | GET |
| Query params (optional) | ?filter=photoframes or ?filter=photobooks |
Response object
| Field | Type | Description |
|---|---|---|
| productId | Integer | The unique id of the product used in an entry. |
| name | String | Full name of the product. |
| price | Integer | Price of the product in cents. |
| options | Array | Array with optional options. |
| options[].name | String | Name of the option. |
| options[].code | String | Code of the option used in an entry. |
| options[].attributes | Array | Array of possible attributes of the option. |
| options[].attributes[].name | String | Name of the attribute. |
| options[].attributes[].code | String | Code of the attribute used in an entry. |
| shippingMethods | Array | Array of shippingMethods used for this product. |
| shippingMethods[].name | String | Name of the shippingMethod. |
| shippingMethods[].pricing | Object (key-value) | Key-value object containing the prices for the countries. ISO-3166 country codes are used as key for countries with a special price and "default" is set for the rest of the possible countries. The value is the price in cents. Note: the item with the highest shipping price is used as the shipping price for the order. |
Example of objects in the response (real response is much, much larger!)
json
{
"productId": 1002201300190001,
"name": "Schoolfotoset A - Papiersoort: Glans",
"price": 127,
"options": [
{
"name": "Witte randen",
"code": "whiteborder",
"attributes": [
{
"name": "Witte randen",
"code": "checked"
}
]
},
{
"name": "Optimalisatie",
"code": "optimalisation",
"attributes": [
{
"name": "Optimalisatie",
"code": "checked"
}
]
}
],
"shippingMethods": [
{
"name": "Brievenbuspost via PostNL",
"pricing": {
"default": 349,
"nl": 249
}
},
{
"name": "Brievenbuspost als pakket via PostNL",
"pricing": {
"default": 899,
"nl": 599
}
}
]
},
{
"productId": 1003705000500003,
"name": "Canvas 2cm (50 x 50) - Houten baklijst: Wit",
"price": 8195,
"options": [
{
"name": "Afwerking randen",
"code": "canvasedge",
"attributes": [
{
"name": "Geen bewerking",
"code": "none"
},
{
"name": "Uitrekken",
"code": "stretch"
},
{
"name": "Spiegelen",
"code": "mirror"
},
{
"name": "Wit laten",
"code": "white"
}
]
}
],
"shippingMethods": [
{
"name": "Pakketpost via PostNL",
"pricing": {
"default": 899,
"nl": 599
}
}
]
}