API та webhooks

Склад, ціни та замовлення —
у зв'язці з вашими системами

Власний сайт, лендінг або система обліку обмінюються з МійДроп напряму: товари, залишки та ціни оновлюються запитами, а про нове замовлення і зміну наявності CRM повідомляє сама.

Спробувати 14 днів безкоштовноТехнічна документація

Готовий PHP-код · До 300 товарів за запит · Журнал кожного виклику

300 товарів
залишки та ціни оновлюються одним запитом
3 події
webhooks про замовлення та наявність товару
готовий код
PHP-приклад під ваш ключ уже в кабінеті
журнал
видно кожен виклик і кожну відповідь

Що можна робити через API

Ключ лежить у розділі «Інтеграції → API» і передається в заголовку кожного запиту

Замовлення

Створення, редагування та отримання замовлень: заявка з сайту потрапляє у спільну таблицю разом із роздрібом і дропшипперами.

Залишки та ціни

Оновлення наявності та всіх типів цін — до 300 товарів за один запит, без вигрузки файлів.

Товари та категорії

Створення та редагування позицій, отримання каталогу у форматі JSON для зовнішньої системи.

Фотографії товарів

Завантаження зображень до позицій — картки на сайті та в CRM залишаються однаковими.

Дропшипери

Отримання списку партнерів і додавання нових із вашої системи.

Виплати

Запити на виплату та замовлення всередині виплати — для звірки у власній бухгалтерії.

Webhooks

Система сама повідомляє вам про подію

Замість постійних запитів «чи не з'явилося щось нове» МійДроп надсилає POST на вашу адресу в момент події — з повними даними замовлення або товару у форматі JSON.

Структура та сама, що у відповідях API, тому обробник пишеться один раз. Адреса для кожної події задається окремо.

Створено замовлення
Ваш сервер отримує дані замовлення у форматі JSON
Замовлення змінено
Зовнішня система оновлює статус і поля
Змінилася наявність товару
Сайт показує актуальний залишок
Видно, що відбувається

Журнал запитів замість здогадок

Кожен виклик API з вашим ключем і кожен надісланий вебхук потрапляють у журнал: час, метод, адреса, код відповіді та повне тіло запиту й відповіді.

Помилку інтеграції видно одразу — не потрібно просити розробника вмикати логи на своєму боці. Журнал доступний власнику акаунта та менеджерам з правом «Інтеграції».

Журнал запитівусі / API / вебхуки
POST/orders200
PUT/products/stock200
HOOKorder_created200
POST/orders422
Клік по рядку розгортає тіло запиту та відповіді: дерево або текст в один клік
Замовлення з лендінгу

Щоб приймати замовлення, писати код не обов'язково

На сторінці «Інтеграції → API» уже лежить приклад на PHP з підставленим ключем вашого акаунта: його достатньо розмістити на сторінці подяки за замовлення — і заявка з лендінгу опиниться в таблиці замовлень.

X-API-KEY:•••••••••
POST/orders
Замовлення в CRM

Як почати обмін

1

Візьміть ключ у кабінеті

Розділ «Інтеграції → API»: там же готовий PHP-приклад і поля для адрес вебхуків.

2

Опишіть обмін на своєму боці

Усі запити, поля та приклади коду зібрані в технічній документації api.mydrop.com.ua.

3

Перевірте за журналом

Зробіть тестове замовлення й подивіться в журналі, що пішло і що повернулося у відповідь.

Як це влаштовано

Інструкція з API та вебхуків для постачальника

Де взяти ключ, які події надсилають вебхуки, як читати журнал запитів і чим замінити API у простих задачах.

Доступні інтеграції

Нова Пошта
Укрпошта
Checkbox
Prom.ua
Rozetka
Horoshop
monobank
ПриватБанк
Показати більше інтеграцій

Часті запитання про API та вебхуки

Де взяти API-ключ?

У розділі «Інтеграції → API» вашого кабінету. Ключ передається в заголовку X-API-KEY кожного запиту, а на тій самій сторінці задаються адреси для вебхуків і відкривається журнал запитів.

Чим webhooks відрізняються від API?

API викликаєте ви, коли вам потрібні дані. Вебхуки працюють навпаки: МійДроп сам надсилає POST на вашу адресу в момент події — так зовнішня система дізнається про замовлення чи зміну залишку одразу, без періодичного опитування.

Про які події надходять вебхуки?

Їх три: створення замовлення, зміна замовлення (ручне редагування або зміна статусу) і зміна наявності товару. У кожному разі на вашу адресу надсилається POST з повними даними у форматі JSON — тієї самої структури, що й у відповідях API.

Чи можна оновлювати залишки пачкою?

Так, за один запит оновлюються наявність і всі типи цін до 300 товарів. Це основний спосіб тримати сайт і CRM в одному стані без вигрузки файлів.

Як приймати замовлення зі звичайного лендінгу?

Для цього не потрібен розробник: на сторінці «Інтеграції → API» уже готовий приклад коду на PHP з вашим ключем — розмістіть його на сторінці подяки за замовлення.

Як перевірити, що інтеграція працює?

За журналом запитів: у ньому видно кожен виклик API і кожен надісланий вебхук — час, метод, адресу, код відповіді та повне тіло запиту й відповіді. Журнал обмежений обсягом, тому дивіться його одразу після тестового замовлення.

У нас немає свого програміста

Частина задач закривається без коду — готовими інтеграціями, ботами та вигрузками. Якщо все ж потрібна індивідуальна інтеграція, напишіть у підтримку: ми підкажемо контакти фахівців, які виконають її за окрему оплату.

Зв'яжіть CRM зі своїми системами

Товари, залишки та замовлення передаються автоматично, а ви бачите кожен обмін у журналі.

Почати безкоштовно