API та Webhooks для постачальників¶
Найгнучкіший спосіб взаємодії з CRM МійДроп — коли готових інтеграцій недостатньо і потрібна власна автоматизація: лендінг, окрема система обліку, індивідуальний сценарій.
Ця стаття — про технічні способи взаємодії: API (ваша система звертається до МійДроп) і Webhooks (МійДроп сам сповіщає вашу систему про події). Якщо ви ще не визначилися зі способом інтеграції, почніть з оглядової статті Способи взаємодії з МійДроп.
Розвивайте свій бізнес разом із МійДроп! Інтегруйтеся з банками та маркетплейсами, отримуйте замовлення через Telegram-бот та багато іншого – https://mydp.co.ua/ITJf8
Що можна робити через API¶
За допомогою API постачальника можна:
- створювати, редагувати та отримувати список замовлень;
- оновлювати залишки та всі типи цін товарів (до 300 товарів за один запит);
- створювати й редагувати товари, категорії, завантажувати фотографії;
- отримувати список товарів і категорій у форматі JSON;
- отримувати запити на виплату та замовлення у виплаті;
- отримувати список дропшиперів і додавати нових.
Де взяти доступ¶
API-ключ знаходиться в розділі "Інтеграції" → "API". Його потрібно передавати в заголовку X-API-KEY кожного запиту.
[ Скріншот: сторінка "Інтеграції" → "API" з полем "Ваш API-ключ" ]
Для приймання замовлень з лендінгу код писати не обовʼязково
На тій самій сторінці "API" є готовий приклад коду на PHP, який достатньо вставити на сторінку подяки за замовлення, замінивши API-ключ.
Повна технічна документація з усіма запитами, полями та прикладами коду: https://api.mydrop.com.ua.
Webhooks / Веб-хуки¶
Якщо API дозволяє вам запитувати дані в МійДроп, то Webhooks (веб-хуки) працюють навпаки: МійДроп сам надсилає HTTP-запит на вказану вами адресу тоді, коли щось стається. Це позбавляє потреби постійно опитувати систему й дозволяє отримувати дані миттєво.
Для постачальника доступні три події:
- 1. Створення замовлення — коли в CRM зʼявляється нове замовлення;
- 2. Зміна замовлення — коли замовлення відредаговано вручну або автоматично змінився його статус;
- 3. Зміна наявності товару — коли змінюється залишок будь-якого товару.
У кожному разі на вашу адресу надсилається POST-запит із повними даними замовлення чи товару у форматі JSON. Це той самий обʼєкт, яким оперує кабінет, тож полів у ньому більше, ніж у відповідях API: артикул товару приходить у products[].product.sku, артикул варіації (розміру) — у products[].size.sku, залишки варіацій — у sizes[].count і sizes[].realCount.
Де налаштувати. У розділі "Інтеграції" → "API", у блоці Webhooks, вкажіть URL для кожної потрібної події та збережіть.
[ Скріншот: блок "Webhooks" на сторінці "API" з трьома полями: "Webhook URL після додавання замовлення", "...при змінах у замовленні", "...при зміні наявності товару" ]
Детальний опис структури запитів — у розділі Webhooks / Веб-хуки технічної документації API.
Як протестувати вебхуки (webhooks)
Щоб швидко перевірити, які саме дані надсилає МійДроп, скористайтеся безкоштовним сервісом webhook.site. Він видасть тимчасовий URL — вставте його в поле Webhook URL у налаштуваннях, і сервіс покаже всі отримані запити з їхнім вмістом. Так зручно розібратися зі структурою даних ще до того, як писати власну обробку.
Журнал запитів¶
Кожен виклик API з вашим ключем і кожен надісланий вебхук потрапляє в журнал акаунта. Для кожного запису видно час, метод і адресу, код відповіді, а також повне тіло запиту та відповіді — зручно перевірити інтеграцію під час налаштування.
Де відкрити. "Інтеграції" → "API" → Журнал запитів (посилання під блоком Webhooks).
[ Скріншот: сторінка "Журнал запитів" зі списком викликів API та вебхуків ]
Що є в журналі:
- фільтр записів — усі, лише запити до API або лише вебхуки;
- клік по рядку розгортає тіло запиту та відповіді;
- перемикач Preview / Raw — дерево з розкриттям вкладених обʼєктів (як у вкладці Network у браузері) або відформатований текст, який копіюється в один клік.
Журнал обмежений обсягом
Нові записи витісняють старі, тому дивіться журнал одразу після тестового замовлення чи налаштування.
Журнал бачить власник акаунта та менеджери з правом "Інтеграції".
Доступ для розробника¶
Якщо інтеграцію налаштовує ваш програміст або підрядник, додайте його в акаунт менеджером з типом «Розробник». Фахівець працюватиме у вашому кабінеті під власним входом, а які розділи йому відкрити, вирішуєте ви.
- Розробник безкоштовний — в оплачену кількість менеджерів він не входить.
- В акаунті може бути один розробник.
Як додати розробника¶
- 1. Відкрийте розділ "Налаштування" і натисніть «Налаштувати менеджерів».
- 2. У формі «Додати менеджера» вкажіть імʼя фахівця й оберіть Тип акаунту: Розробник. У блоці «Має доступ до розділів» відмітьте розділи, які розробнику потрібно бачити, — наприклад, "Замовлення" і "Склад", щоб перевіряти, як інтеграція передає замовлення та залишки. Розділ "Інтеграції" увімкнений завжди.
- 3. За потреби відмітьте «Експортувати замовлення» і налаштуйте блоки «Бачить» та «Отримує повідомлення» — вони працюють так само, як у звичайного менеджера (детально — у статті Акаунти менеджерів). Натисніть «Додати менеджера».
- 4. Розробник зʼявиться у списку менеджерів з позначкою «Розробник». Натисніть «Копіювати» в колонці «Посилання для запрошення» і надішліть посилання фахівцю.
- 5. Фахівець відкриває посилання, входить у свій акаунт МійДроп (або реєструється) і натискає «Приєднатися». Після цього в колонці «Активований» зʼявиться «Так».
Надалі розробник входить тим самим способом, яким приєднувався (Google, Telegram тощо), і одразу потрапляє у ваш кабінет.
Що доступно розробнику¶
У меню розробника — відмічені вами розділи, "Інтеграції" та "AI-асистент". "Чати", "Telegram-бот", "Допомога" і "Налаштування" є в меню в усіх менеджерів.
Розділ "Інтеграції" розробник налаштовує сам:
- API — копіює й перевипускає API-ключ, налаштовує вебхуки, переглядає журнал запитів, підключає додатки на API;
- Prom, Rozetka, Хорошоп, Google-таблиці, інтернет-магазин на базі CRM, Telegram-канали;
- монобанк, ПриватБанк, WayForPay;
- каси Checkbox і Вчасно.Каса, друковані форми;
- чати — підключення акаунтів, шаблони відповідей, автовідповіді та статуси.
Також розробник формує вигрузки товарів, а експорт замовлень — якщо ви відмітили «Експортувати замовлення».
Решту розробник лише переглядає. Він не створює й не редагує замовлення та товари, не проводить надходження й списання, не створює ТТН і фіскальні чеки, не надсилає SMS, не відповідає клієнтам у чатах і не змінює налаштування акаунта. Якщо розробник спробує зберегти такі зміни, кабінет покаже повідомлення «Розробник може змінювати лише інтеграції — решта доступна для перегляду». Розділ "Менеджери" йому недоступний: менеджерів і їхні права налаштовують власник акаунта та адміністратори.
AI-асистента (MCP) розробник може підключити лише для читання даних — для цього в налаштуваннях менеджера (значок редагування в списку менеджерів) увімкніть «AI: читання даних (MCP)».
API-ключ дає повний доступ до акаунта
Обмеження розробника діють у кабінеті. Запити з API-ключем виконуються від імені акаунта — так інтеграція створює замовлення й оновлює товари. Коли роботу завершено, видаліть розробника: значок редагування в списку менеджерів → «Видалити менеджера». За потреби перевипустіть ключ на сторінці "API" — старий одразу перестане працювати.
Тип «Розробник» змінити не можна. Щоб видати фахівцю ширші права, видаліть розробника й додайте його звичайним менеджером.
Немає свого програміста?¶
Налаштування API та вебхуків — технічне завдання, і для нього зазвичай потрібен розробник. Якщо у вас немає власного програміста чи спеціаліста з налаштування API, ми можемо надати контакти фахівців, які виконають індивідуальну інтеграцію за додаткову оплату. Для цього зверніться в підтримку МійДроп — напишіть менеджеру Анні.
Не завжди потрібен API¶
Часто задачу можна вирішити простіше — без коду й розробника. Перш ніж братися за API, перевірте, чи не підійде один із цих способів:
- Готові інтеграції — підключення Prom, Rozetka, Хорошоп, WooCommerce, Google-таблиць та інших налаштовується в кабінеті в кілька кліків. Повний перелік — у статті Список доступних інтеграцій.
- Персональний Telegram-бот — дропшипери подають вам замовлення прямо у вашому власному Telegram-боті, без лендінгу й коду. Детально — у статті Персональний Telegram-бот.
- Роздрібний Telegram-бот — роздрібні покупці переглядають товари й оформлюють замовлення прямо в Telegram, через бота вашого інтернет-магазину на базі CRM. Детально — у статті Інтернет-магазин на базі CRM (Крок 8).
- Імпорт товарів через вигрузку (файл або посилання-фід у форматі YML/XML/XLSX) — щоб перенести товари з іншого майданчика в CRM з автоматичною синхронізацією. Детально — у статті Імпорт товарів.
- Експорт товарів через вигрузку (посилання у форматі YML/XML) — щоб віддати каталог дропшиперам або на власний сайт. Детально — у статті Вигрузка товарів для дропшиперів.
Розвивайте свій бізнес разом із МійДроп! Генеруйте ТТН, отримуйте сповіщення про статуси посилок в Telegram та багато іншого – https://mydp.co.ua/ITJf8