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, ми можемо надати контакти фахівців, які виконають індивідуальну інтеграцію за додаткову оплату. Для цього зверніться в підтримку МійДроп — напишіть менеджеру Анні.
Не завжди потрібен API¶
Часто задачу можна вирішити простіше — без коду й розробника:
-
Експорт товарів постачальника через вигрузку (посилання у форматі YML/XML) — щоб наповнити свої майданчики товарами. Детально — у статті Експортувати товари постачальника.
-
Облік по власних постачальниках — щоб вести замовлення по постачальниках, які не користуються МійДроп, без будь-яких інтеграцій. Детально — у статті Додати своїх постачальників.
Розвивайте свій бізнес разом із МійДроп! Генеруйте ТТН, робіть SMS-розсилки клієнтам та багато іншого – https://mydp.co.ua/raX91