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).
Де налаштувати. У розділі "Інтеграції" → "API", у блоці Webhooks, вкажіть URL для кожної потрібної події та збережіть.
[ Скріншот: блок "Webhooks" на сторінці "API" з трьома полями: "Webhook URL після додавання заказу", "...при зміні заказу", "...при зміні наявності товару" ]
Детальний опис структури запитів — у розділі Webhooks / Веб-хуки технічної документації API.
Як протестувати вебхуки (webhooks)
Щоб швидко перевірити, які саме дані надсилає МійДроп, скористайтеся безкоштовним сервісом webhook.site. Він видасть тимчасовий URL — вставте його в поле Webhook URL у налаштуваннях, і сервіс покаже всі отримані запити з їхнім вмістом. Так зручно розібратися зі структурою даних ще до того, як писати власну обробку.
Немає свого програміста?¶
Налаштування 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