У цій статті розглянемо як створити термоетикетку для посилки.
Крок 1: Підготуйте та надішліть запит
API Endpoint
Щоб створити етикетку, потрібно надіслати HTTP GET запит до https://api.novapost.com/v.1.0/shipments/print.
Headers
Існує два HTTP-заголовки, які потрібно вказати у запиті:
- 1Accept: Вказує формат відповіді. Використовуйте формат PDF наступним чином: application/pdf
- 2Authorization: Для цього заголовка потрібно передати ваш JWT-токен
Запит Body
У тілі HTTP-запиту ви вказуєте всю інформацію про термоетикетку, яку хочете створити, наприклад, номери відправлень, тип етикетки та розмір. Створімо етикетку з наступними критеріями:
- 1numbers: Номери відправлень.
- 2type: Може набути значень marking, international, invoice.
- 3printSizeType: Може набути значень size_100_100, size_A4.
- 4copies: Кількість копій.
- Приклад запиту:
curl -X GET "https://api.novapost.pl/v1.0/shipments/print?numbers[]=SHPL1234567890&type=international&printSizeType=size_A4" \
-H "Accept: application/pdf" \
-H "Authorization: Bearer your_fresh_genereted_token_Nzk2NjY1NzZ9.kABs72NjY1NzZ9.kABs7W8h"
Ці URL-адреси схожі на будь-які інші URL-адреси, тобто ви можете вставити їх у браузер, щоб завантажити файл. Ви також можете завантажити етикетку за допомогою curl.
Крок 2: Завантаження етикетки
Якщо ваш запит був успішним, у відповідь ви отримаєте файл у форматі PDF.
Крок 3: Роздрукуйте етикетку на термопринтері
Після завантаження файлу етикетки ви можете роздрукувати його на термопринтері.