Технічна документація для розробників. Підключіть BaseLinker, WooCommerce, Apilo або власне WMS/ERP рішення безпосередньо до Scopio Marketplace. Забезпечте автоматичне отримання замовлень та миттєву синхронізацію статусів доставки.
Ключі API Продавця
Кожен запит до API Scopio має бути авторизований за допомогою унікального токену продавця. Цей токен генерується в панелі керування. Використовуйте заголовок Authorization з префіксом Bearer або напряму X-API-Key.
Токени мають права доступу, прив'язані до вашого профілю продавця. Зберігайте їх у безпечному місці (наприклад, у змінних оточення) і ніколи не передавайте клієнтському коду. API підтримує виключно шифрування TLS 1.3.
# Authorization Header
Authorization: Bearer sk_mkt_ca1d5b9...
X-API-Key: sk_mkt_ca1d5b9...
Ендпоінт: GET /api/seller/orders
Ендпоінт дозволяє автоматично отримувати нові оплачені замовлення. Він повертає виключно позиції замовлення, які належать до вашої пропозиції (фільтрація за sellerId). Адреси клієнтів та способи доставки передаються у форматі JSON.
Рекомендований інтервал опитування (polling) становить від 5 до 15 хвилин. Відповідь містить структуру shipping_address з повними контактними даними покупця, списком замовлених товарів, кодами EAN, кількістю та цінами.
# Response excerpt
{ "success": true, "orders": [...] }
Ендпоінт: POST /api/seller/orders/{orderId}/fulfill
Після пакування посилки та створення транспортної етикетки у вашій системі (наприклад, BaseLinker), надішліть статус виконання назад до Scopio. Вкажіть трек-номер та ідентифікатор перевізника, і статус миттєво оновиться.
Дозволені ідентифікатори перевізників: inpost_locker (Поштомати), inpost_courier, dpd, dhl, ups. Ви також можете передати пряме посилання на PDF етикетки (label_url), щоб вона відображалася в кабінеті Scopio.
# Payload data
{ "tracking_number": "XYZ123", "carrier": "inpost_locker" }
Миттєві події HTTP POST
Налаштуйте адресу Webhook URL у своєму кабінеті продавця, щоб отримувати сповіщення в реальному часі. Система надішле запит POST на вказану адресу одразу після оплати замовлення покупцем.
Кожне вебхук-сповіщення містить заголовок підпису (signature), який генерується за допомогою Webhook Secret. Це дозволяє перевірити автентичність відправника. У разі помилки надсилання буде повторено 3 рази.
Готовність до економіки AI-агентів
Усі структури замовлень та статусів повністю відповідають стандарту Universal Commerce Protocol (UCP). Це дозволяє автономним пошуковим ботам та ШІ-агентам легко зчитувати та обробляти деталі замовлень.
Завдяки формату UCP замовлення від автоматизованих систем покупок без проблем інтегруються у вашу CRM без написання спеціального коду для кожного окремого боту.
Безпека та стабільність інфраструктури
Стандартний ліміт запитів до API становить 120 запитів на хвилину на один ключ API або IP-адресу. Перевищення ліміту повертає код HTTP 429. Усі помилки передаються у форматі JSON із описом помилки.
API повертає стандартні коди HTTP: 400 (невірний вміст), 401 (немає авторизації), 403 (немає доступу до замовлення), 404 (замовлення не знайдено), 500 (помилка сервера). Всі помилки логуються.
# HTTP 429 Rate Limit Response
{ "error": "Too Many Requests", "retry_after_seconds": 60 }
