API
Here you can find basic information about the API. All other technical API documentation can be found in portal.print.one.
📄️ API Documentation
In this help center, you will mainly find information on graphical aspects, delivery specifications, links to data platforms, and other explanations.
📄️ Authentication and API Keys
Authentication with the API is done using API keys. For API requests, the API key can be sent along in the headers. The header key for this is x-api-key.
📄️ Example JSON
Note: Where 'tmpl_12345678900987654321' appears, the template ID should be entered.
📄️ API status codes
All status codes starting with a 2 (e.g. 201) represent success.
📄️ Address Validation
The Print.one API has support for address validation whenever you try to make a request. There is a general address validation which is done for all countries, but also address validation for some specific countries. You will find details on all of these validations below.
📄️ Rate Limiting
Unless otherwise stated in the API documentation, all endpoints have a rate limit of 60 requests every 30 seconds.
📄️ Idempotency
Our API supports idempotency for safely retrying requests without accidentally performing the same operation twice. When creating or updating an object (order, template), use an idempotency key. If a connection error then occurs, you can safely retry the request without risking creating a second object (order, template) or performing the update twice.
📄️ Postman settings
Postman is an application which is used by many developers to test API's. In a lot of cases you do not need Postman. In most marketing platforms certain features are present to test API requests / webhooks.
📄️
📄️ CSV automation
With CSV files, you have an alternative way to submit orders. Each row in the CSV is considered as a new order.