Веб-хуки

Вкладка Webhooks дозволяє налаштувати спеціальні адреси, на які буде надсилатися інформація про виконані дії зовнішньому сервісу.

Доступні опції

Ось список доступних опцій з коротким поясненням.

Вебхук після замовлення

Вказує URL адресу, на яку буде відправлено запит типу POST з інформацією про замовлення в форматі JSON.

Порада

При виконанні інтеграції, будь ласка, враховуйте той факт, що ми не пропонуємо версійність структури даних у веб-хуках. І як наслідок - у даних, що повертаються, можуть з’явитися нові змінні. Покладання на структуру даних 1:1 може призвести до помилок у майбутньому. Найбезпечніший варіант - отримувати кожну змінну з рядка JSON окремо і не припускати, наприклад, що об’єкт address не буде заповнений додатковою інформацією в майбутньому.

приклад формату даних, що передаються webhook.

{
   "encoded_id":"123-456-789",
   "number":"123/03/2020",
   "total_price":"138.45",
   "total_copies": "3",
   "total_photos": "2",
   "buyer":{
      "email": "test@email.com",
      "phone": "+48 000 000 000",
      "comment": "Comment on order",
      "address":{
         "parcel_locker":null,
         "is_company": "0",
         "company_name":null,
         "company_nip":null,
         "name": "Jan Kowalski",
         "street": "9 Jasmine Street",
         "postcode": "12-345",
         "city": "Cracow",
         "country": "Poland"
      }
   },
   "delivery":{
      "id": "2",
      "name": "Personal collection (Online payment)",
      "price": "15.00"
   },
   "coupon":{
      "code":null,
      "price":null
   },
   "items":[
      {
         "size_id": "3",
         "size_folder":"13x18",
         "file_name":"Photo101.jpg",
         "copies": "1",
         "paper": "matte",
         "price": "23.25"
      },
      {
         "size_id": "1",
         "size_folder":"9x13",
         "file_name":"Photo022.jpg",
         "copies": "2",
         "paper": "glossy",
         "price": "50.10"
      }
   ]
}