CloudSignal Webhooks

This documentation describes the CloudSignal Webhooks v1.1

---

Getting started

To get started with Cloudprinter please contact us at info@cloudprinter.com to get your account created. To each account is associated an API key, which is used as authentication in all API calls. Each webhook request includes a Webhook API key, which is different from the account API key. This Webhook API key sould be validated on each request.

---

Basics

RESTful API

The CloudSignal Webhooks is RESTful. All calls are implemented as HTTP post and TLS encrypted. The HTTP response code 200 is expected on positive calls, all other response codes is considered as error.

Request Data

All request data posted is in JSON objects. The documentation for each webhook describes the request data parameters in detail.

Return Data

No return data is expected and will be ignored.

Your RESTful API endpoint

Each client can have one RESTful API endpoint for use with CloudSignal Webhooks. The endpoint URL is configured by Cloudprinter.

Retry

CloudSignal Webhooks will retry sending signals if HTTP status 200 or 204 is not returned. Max 100 attempts over 7 days.

---

Signals

CloudprinterOrderValidated

Order received and validated by Cloudprinter.

Example request

{
    "apikey": "13b37bb1ed6d3403e158abe719b4f6d0",
    "type": "CloudprinterOrderValidated",
    "order": "123456780000",
    "datetime": "2017-01-21T14:28:52+0100"
}

Parameters

Name	Type	Description	Required
apikey	string	api access key	required
type	string	valid value: "CloudprinterOrderValidated"	required
order	string	the full order id	required
datetime	string	ISO 8601 timestamp	required

HTTP Status codes

Code	Status	Description
200	OK	the request has succeeded
204	No content	the request has succeeded, order not found
400	Bad request	the request was invalid or parameters are missing. Causes signal delivery retry

---

CloudprinterItemValidated

Item received and validated by the production.

Example request

{
    "apikey": "13b37bb1ed6d3403e158abe719b4f6d0",
    "type": "ItemValidated",
    "order": "123456780000",
    "item": "123456780001",
    "datetime": "2017-01-21T14:28:52+0100"
}

Parameters

Name	Type	Description	Required
apikey	string	api access key	required
type	string	valid value: "CloudprinterItemValidated"	required
order	string	the full order id	required
item	string	the full item id	required
datetime	string	ISO 8601 timestamp	required

HTTP Status codes

Code	Status	Description
200	OK	the request has succeeded
204	No content	the request has succeeded, order not found
400	Bad request	the request was invalid or parameters are missing.
Causes signal delivery retry

---

ItemProduce

Production has started for item.

Example request

{
    "apikey": "13b37bb1ed6d3403e158abe719b4f6d0",
    "type": "ItemProduce",
    "order": "123456780000",
    "item": "123456780001",
    "datetime": "2017-01-21T14:28:52+0100"
}

Parameters

Name	Type	Description	Required
apikey	string	api access key	required
type	string	valid value: "ItemProduce"	required
order	string	the full order id	required
item	string	the full item id	required
datetime	string	ISO 8601 timestamp	required

HTTP Status codes

Code	Status	Description
200	OK	the request has succeeded
204	No content	the request has succeeded, order not found
400	Bad request	the request was invalid or parameters are missing. Causes signal delivery retry

---

ItemProduced

Production completed for item.

Example request

{
    "apikey": "13b37bb1ed6d3403e158abe719b4f6d0",
    "type": "ItemProduced",
    "order": "123456780000",
    "item": "123456780001",
    "datetime": "2017-01-21T14:28:52+0100"
}

Parameters

Name	Type	Description	Required
apikey	string	api access key	required
type	string	valid value: "ItemProduced"	required
order	string	the full order id	required
item	string	the full item id	required
datetime	string	ISO 8601 timestamp	required

HTTP Status codes

Code	Status	Description
200	OK	the request has succeeded
204	No content	the request has succeeded, order not found
400	Bad request	the request was invalid or parameters are missing.

Causes signal delivery retry

---

ItemPacked

Item has been packed.

Example request

{
    "apikey": "13b37bb1ed6d3403e158abe719b4f6d0",
    "type": "ItemPacked",
    "order": "123456780000",
    "item": "123456780001",
    "datetime": "2017-01-21T14:28:52+0100"
}

Parameters

Name	Type	Description	Required
apikey	string	api access key	required
type	string	valid value: "ItemPacked"	required
order	string	the full order id	required
item	string	the full item id	required
datetime	string	ISO 8601 timestamp	required

HTTP Status codes

Code	Status	Description
200	OK	the request has succeeded
204	No content	the request has succeeded, order not found
400	Bad request	the request was invalid or parameters are missing.
Causes signal delivery retry

---

ItemShipped

Item has been shipped. The tracking code for the packet is included in this signal.

Example request

{
    "apikey": "13b37bb1ed6d3403e158abe719b4f6d0",
    "type": "ItemShipped",
    "order": "123456780000",
    "item": "123456780001",
    "tracking": "1A2B3C4D5E6F",
    "shipping_option": "GLS",
    "datetime": "2017-01-21T14:28:52+0100"
}

Parameters

Name	Type	Description	Required
apikey	string	api access key	required
type	string	valid value: "ItemShipped"	required
order	string	the full order id	required
item	string	the full item id	required
tracking	string	tracking code for the item	required
shipping_option	string	shipping option	required
datetime	string	ISO 8601 timestamp	required

HTTP Status codes

Code	Status	Description
200	OK	the request has succeeded
204	No content	the request has succeeded, order not found
400	Bad request	the request was invalid or parameters are missing.
Causes signal delivery retry

---

ItemError

Item has problem or error. This could be due print error or failed in quality check etc.

Example request

{
    "apikey": "13b37bb1ed6d3403e158abe719b4f6d0",
    "type": "ItemError",
    "order": "123456780000",
    "item": "123456780001",
    "cause": "Print error, reprint needed",
    "delay": "24",
    "datetime": "2017-01-21T14:28:52+0100"
}

Parameters

Name	Type	Description	Required
apikey	string	api access key	required
type	string	valid value: "ItemError"	required
order	string	the full order id	required
item	string	the full item id	required
cause	string	text string explaning the error	optional
delay	string	expected delay in hours	optional
datetime	string	ISO 8601 timestamp	required

HTTP Status codes

Code	Status	Description
200	OK	the request has succeeded
204	No content	the request has succeeded, order not found
400	Bad request	the request was invalid or parameters are missing.
Causes signal delivery retry

---

ItemCanceled

Item has been canceled.

Example request

{
    "apikey":"73ab8e8194d36f7f6f2305ce50cfba27",
    "type":"ItemCanceled",
    "order":"71600000000",
    "item":"71600050016",
    "order_reference":"102603",
    "item_reference":"415",
    "cause": "190",
    "message": "Example message",
    "datetime":"2017-01-21T14:28:52+0100"
}

Parameters

Name	Type	Description	Required
apikey	string	api access key	required
type	string	valid value: "ItemCanceled"	required
order	string	the full order id	required
item	string	the full item id	required
order_reference	string	the full order_reference number	required
item_reference	string	the full item_erference number	required
cause	string	cause id	optional
message	string	reason for cancellation	optional
datetime	string	ISO 8601 timestamp	required

HTTP Status codes

Code	Status	Description
200	OK	the request has succeeded
204	No content	the request has succeeded, order not found
400	Bad request	the request was invalid or parameters are missing.
Causes signal delivery retry