API та Webhooks для дропшиперів¶
Найгнучкіший спосіб взаємодії з CRM МійДроп — коли готових інструментів недостатньо: наприклад, для приймання замовлень із власного лендінгу чи синхронізації з окремою системою.
Ця стаття — про технічні способи взаємодії: API (ваша система звертається до МійДроп) і Webhooks (МійДроп сам сповіщає вашу систему про події). Якщо ви ще не визначилися зі способом інтеграції, почніть з оглядової статті Способи взаємодії з МійДроп.
Доступно в пакеті PREMIUM
API для дропшиперів доступне в тарифному пакеті PREMIUM.
Розвивайте свій бізнес разом із МійДроп! Ведіть облік замовлень, формуйте запити на виплату та багато іншого – https://mydp.co.ua/raX91
Що можна робити через API¶
За допомогою API дропшипера можна:
-
створювати нові замовлення в CRM;
-
отримувати список замовлень;
-
отримувати інформацію про конкретне замовлення за його ID.
Створити замовлення можна двома способами: за назвою постачальника й товару або за назвою товару та артикулом (sku). Якщо для товарів заздалегідь заданий префікс артикула, постачальник для нових товарів визначатиметься автоматично за збігом префікса.
Де взяти доступ¶
API-ключ знаходиться в розділі "API" вашого кабінету. Його потрібно передавати в заголовку X-API-KEY кожного запиту.
[ Скріншот: сторінка "API" в кабінеті дропшипера з полем "Ваш API-ключ" ]
Готовий код
На сторінці "API" є готовий приклад коду на PHP та повний приклад лендінгу.
Повна технічна документація з усіма запитами, полями та прикладами коду: https://api.mydrop.com.ua.
Webhooks / Веб-хуки¶
Якщо API дозволяє вам запитувати дані в МійДроп, то Webhooks (веб-хуки) працюють навпаки: МійДроп сам надсилає HTTP-запит на вказану вами адресу тоді, коли щось стається. Це дозволяє отримувати дані про замовлення миттєво, не опитуючи систему постійно.
Для дропшипера доступні дві події:
-
1. Створення замовлення — коли в CRM зʼявляється нове замовлення;
-
2. Зміна замовлення — коли замовлення відредаговано вручну або автоматично змінився його статус.
На вашу адресу надсилається POST-запит із повними даними замовлення у форматі JSON (така сама структура, як у відповідях API).
Де налаштувати. У розділі "API", у блоці Webhooks, вкажіть URL для кожної потрібної події та збережіть.
[ Скріншот: блок "Webhooks" на сторінці "API" в кабінеті дропшипера з двома полями: "Webhook URL після додавання заказу" та "...при зміні заказу" ]
Детальний опис структури запитів — у розділі Webhooks / Веб-хуки технічної документації API.
Як протестувати вебхуки (webhooks)
Щоб швидко перевірити, які саме дані надсилає МійДроп, скористайтеся безкоштовним сервісом webhook.site. Він видасть тимчасовий URL — вставте його в поле Webhook URL у налаштуваннях, і сервіс покаже всі отримані запити з їхнім вмістом. Так зручно розібратися зі структурою даних ще до того, як писати власну обробку.
Журнал запитів¶
Кожен виклик API з вашим ключем і кожен надісланий вебхук потрапляє в журнал акаунта. Для кожного запису видно час, метод і адресу, код відповіді, а також повне тіло запиту та відповіді — зручно перевірити інтеграцію під час налаштування.
Де відкрити. Розділ "API" → Журнал запитів (посилання під блоком Webhooks).
[ Скріншот: сторінка "Журнал запитів" у кабінеті дропшипера зі списком викликів API та вебхуків ]
Що є в журналі:
-
фільтр записів — усі, лише запити до API або лише вебхуки;
-
клік по рядку розгортає тіло запиту та відповіді;
-
перемикач Preview / Raw — дерево з розкриттям вкладених обʼєктів (як у вкладці Network у браузері) або відформатований текст, який копіюється в один клік.
Журнал обмежений обсягом
Нові записи витісняють старі, тому дивіться журнал одразу після тестового замовлення чи налаштування.
Журнал бачить власник акаунта та менеджери з правом "Інтеграції".
Немає свого програміста?¶
Налаштування API та вебхуків — технічне завдання, і для нього зазвичай потрібен розробник. Якщо у вас немає власного програміста чи спеціаліста з налаштування API, ми можемо надати контакти фахівців, які виконають індивідуальну інтеграцію за додаткову оплату. Для цього зверніться в підтримку МійДроп — напишіть менеджеру Анні.
Не завжди потрібен API¶
Часто задачу можна вирішити простіше — без коду й розробника:
-
Експорт товарів постачальника через вигрузку (посилання у форматі YML/XML) — щоб наповнити свої майданчики товарами. Детально — у статті Експортувати товари постачальника.
-
Облік по власних постачальниках — щоб вести замовлення по постачальниках, які не користуються МійДроп, без будь-яких інтеграцій. Детально — у статті Додати своїх постачальників.
Розвивайте свій бізнес разом із МійДроп! Генеруйте ТТН, робіть SMS-розсилки клієнтам та багато іншого – https://mydp.co.ua/raX91