Dokumentacja API

Pełna specyfikacja endpointów DropShoping — autoryzacja, produkty, sklepy, hurtownie, webhooki i przykłady cURL.

Wprowadzenie

DropShoping udostępnia dwa sposoby autoryzacji: klucz API dla integracji zewnętrznych (/api/v1/*) oraz token JWT po zalogowaniu do panelu (/api/*).

Bazowy URL

https://twoja-domena.pl

Format odpowiedzi

JSON · UTF-8 · błędy jako { "error": "..." }

200  OK — sukces
201  Created — utworzono zasób
400  Bad Request — błąd walidacji body
401  Unauthorized — brak lub nieprawidłowa autoryzacja
404  Not Found — zasób nie istnieje
500  Internal Server Error — błąd serwera

Autoryzacja

Klucz API (integracje)

Nagłówek:

X-API-Key: ds_...

Alternatywnie: Authorization: Bearer ds_...

Generuj klucz →

Sesja JWT (panel)

Po POST /api/auth/login:

Authorization: Bearer eyJ...

Token ważny 7 dni. Używany przez panel webowy.

Webhook Nouviro

Przychodzące POST z nagłówkiem X-Nouviro-Signature (HMAC). Konfigurujesz URL w Nouviro z parametrem connectionId.

POST/api/auth/loginPubliczne

Logowanie (sesja panelu)

Zwraca token JWT używany w panelu webowym i requestach z Authorization: Bearer.

Body (JSON)

Pole	Typ	Opis
email*	string	Adres email konta
password*	string	Hasło

{
  "email": "jan@example.com",
  "password": "twoje_haslo"
}

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": {
    "id": "clxxx",
    "email": "jan@example.com",
    "name": "Jan"
  }
}

curl -X POST https://twoja-domena.pl/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"jan@example.com","password":"haslo"}'

POST/api/auth/registerPubliczne

Rejestracja konta

Tworzy konto użytkownika i zwraca token JWT.

Body (JSON)

Pole	Typ	Opis
email*	string	Unikalny email
password*	string	Min. 6 znaków
name	string	Imię lub nazwa firmy

{
  "email": "jan@example.com",
  "password": "haslo123",
  "name": "Jan Kowalski"
}

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": { "id": "clxxx", "email": "jan@example.com", "name": "Jan Kowalski" }
}

GET/api/auth/meSesja JWT (Bearer)

Bieżący użytkownik

Zwraca dane zalogowanego użytkownika na podstawie tokena JWT.

{
  "id": "clxxx",
  "email": "jan@example.com",
  "name": "Jan Kowalski"
}

GET/api/keysSesja JWT (Bearer)

Lista kluczy API

Zwraca aktywne klucze (bez pełnej wartości — tylko prefix).

[
  {
    "id": "clxxx",
    "name": "Integracja ERP",
    "keyPrefix": "ds_a1b2c3d4",
    "isActive": true,
    "lastUsedAt": "2026-07-09T12:00:00.000Z",
    "createdAt": "2026-07-01T10:00:00.000Z"
  }
]

POST/api/keysSesja JWT (Bearer)

Generuj klucz API

Tworzy klucz do API zewnętrznego (/api/v1/*). Pełny klucz zwracany jest tylko raz w polu key.

Body (JSON)

Pole	Typ	Opis
name*	string	Etykieta klucza

{
  "id": "clxxx",
  "name": "Integracja ERP",
  "key": "ds_64znakowyhex...",
  "keyPrefix": "ds_a1b2c3d4",
  "message": "Zapisz klucz teraz. Nie będzie widoczny ponownie."
}

API zewnętrzne (v1)

Endpointy /api/v1/* wymagają klucza API z sekcji Klucze API. Identyfikator sklepu (shopConnectionId) pobierzesz z Kanały sprzedaży.

GET/api/v1/productsKlucz API (X-API-Key)

Lista produktów

Główny endpoint API zewnętrznego. Zwraca produkty z źródłami cen i aktywnymi ofertami w sklepach.

{
  "products": [
    {
      "id": "clxxx",
      "name": "Słuchawki Pro",
      "sku": "SLU-001",
      "sources": [
        {
          "id": "clxxx",
          "platform": "bigbuy",
          "sourceUrl": "wholesaler://bigbuy/12345",
          "currentPrice": 34.2,
          "isAvailable": true,
          "isLowest": true
        }
      ],
      "listings": [
        {
          "id": "clxxx",
          "status": "ACTIVE",
          "listedPrice": 41.04,
          "shopConnection": { "name": "Sklep WooCommerce", "platform": "WOOCOMMERCE" }
        }
      ]
    }
  ]
}

curl https://twoja-domena.pl/api/v1/products \
  -H "X-API-Key: ds_twoj_klucz"

POST/api/v1/productsKlucz API (X-API-Key)

Dodaj produkt i wystaw w sklepie

Tworzy produkt z co najmniej jednym źródłem ceny i od razu publikuje ofertę w podłączonym sklepie (z marżą z ustawień).

Body (JSON)

Pole	Typ	Opis
name*	string	Nazwa produktu
sku	string	SKU / identyfikator
description	string	Opis produktu
imageUrl	string (url)	URL zdjęcia
shopConnectionId*	string	ID z sekcji Kanały sprzedaży
sources*	array	Min. 1 źródło ceny
sources[].sourceUrl*	string (url)	URL produktu u dostawcy lub wholesaler://bigbuy/ID
sources[].platform*	string	Np. bigbuy, cj_dropshipping, amazon
sources[].compareOnly	boolean	true dla Allegro/Ceneo — tylko porównanie

{
  "name": "Słuchawki bezprzewodowe Pro",
  "sku": "SLU-001",
  "description": "Opis produktu",
  "imageUrl": "https://example.com/img.jpg",
  "shopConnectionId": "clxxx_id_sklepu",
  "sources": [
    {
      "sourceUrl": "wholesaler://bigbuy/12345",
      "platform": "bigbuy"
    },
    {
      "sourceUrl": "https://www.ceneo.pl/123456",
      "platform": "ceneo",
      "compareOnly": true
    }
  ]
}

{
  "product": { "id": "clxxx", "name": "Słuchawki...", "sources": [...] },
  "listing": {
    "id": "clxxx",
    "status": "ACTIVE",
    "listedPrice": 41.04,
    "sourcePrice": 34.2,
    "marginPercent": 20,
    "externalId": "123"
  }
}

curl -X POST https://twoja-domena.pl/api/v1/products \
  -H "X-API-Key: ds_twoj_klucz" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Słuchawki Pro",
    "shopConnectionId": "clxxx",
    "sources": [{
      "sourceUrl": "wholesaler://bigbuy/12345",
      "platform": "bigbuy"
    }]
  }'

·Marża liczona z ustawień konta (defaultMarginPercent, minMarginAmount) i reguł per kategoria
·Platformy porównawcze (Allegro, Ceneo) nie mogą być jedynym źródłem zakupu

Produkty

GET/api/productsSesja JWT (Bearer)

Lista produktów (panel)

To samo co v1, ale przez sesję JWT z panelu.

POST/api/productsSesja JWT (Bearer)

Utwórz produkt (panel)

Tworzy produkt. Jeśli podasz shopConnectionId — od razu wystawia ofertę. Obsługuje category i sourcePriority (fallback źródeł).

Body (JSON)

Pole	Typ	Opis
name*	string	Nazwa
category	string	Kategoria — do reguł marży
shopConnectionId	string	Opcjonalnie — wystaw od razu
sources[].sourcePriority	number	1 = pierwsze, 2 = zapasowe

{
  "name": "Lampa LED",
  "category": "elektronika",
  "shopConnectionId": "clxxx",
  "sources": [
    { "sourceUrl": "wholesaler://cj_dropshipping/abc", "platform": "cj_dropshipping", "sourcePriority": 1 },
    { "sourceUrl": "wholesaler://bigbuy/999", "platform": "bigbuy", "sourcePriority": 2 }
  ]
}

PUT/api/productsSesja JWT (Bearer)

Wystaw istniejący produkt

Publikuje istniejący produkt w wybranym sklepie.

Body (JSON)

Pole	Typ	Opis
productId*	string	ID produktu
shopConnectionId*	string	ID sklepu

{ "productId": "clxxx", "shopConnectionId": "clxxx" }

Kanały sprzedaży

GET/api/shopsSesja JWT (Bearer)

Lista kanałów sprzedaży

Zwraca podłączone sklepy z liczbą aktywnych ofert.

[
  {
    "id": "clxxx",
    "name": "Sklep WooCommerce",
    "platform": "WOOCOMMERCE",
    "shopUrl": "https://sklep.pl",
    "isActive": true,
    "_count": { "listings": 12 }
  }
]

POST/api/shopsSesja JWT (Bearer)

Podłącz sklep

Tworzy połączenie z kanałem sprzedaży.

Body (JSON)

Pole	Typ	Opis
name*	string	Nazwa w panelu
platform*	enum	WOOCOMMERCE \| SHOPIFY \| PRESTASHOP \| NOUVIRO \| CUSTOM
shopUrl*	string (url)	URL sklepu lub API
apiKey	string	Klucz API sklepu
apiSecret	string	Secret / webhook secret
accessToken	string	Token Shopify

{
  "name": "Sklep WooCommerce",
  "platform": "WOOCOMMERCE",
  "shopUrl": "https://sklep.pl",
  "apiKey": "ck_...",
  "apiSecret": "cs_..."
}

DELETE/api/shops?id={id}Sesja JWT (Bearer)

Usuń połączenie sklepu

Trwale usuwa połączenie z kanałem sprzedaży.

Parametry query

Pole	Typ	Opis
id*	string	ID połączenia

Hurtownie

wholesaler://{platform}/{externalId}

Przykłady:
  wholesaler://bigbuy/12345
  wholesaler://cj_dropshipping/abc123

GET/api/wholesalersSesja JWT (Bearer)

Lista hurtowni

Zwraca podłączone hurtownie (BigBuy, CJ Dropshipping).

POST/api/wholesalersSesja JWT (Bearer)

Podłącz hurtownię

Dodaje połączenie z hurtownią dropshippingową.

Body (JSON)

Pole	Typ	Opis
name*	string	Nazwa połączenia
provider*	enum	BIGBUY \| CJ_DROPSHIPPING
apiKey*	string	Klucz API hurtowni
apiSecret	string	Secret (CJ)

{
  "name": "BigBuy EU",
  "provider": "BIGBUY",
  "apiKey": "twoj_klucz_bigbuy"
}

PUT/api/wholesalersSesja JWT (Bearer)

Synchronizuj katalog hurtowni

Pobiera i aktualizuje produkty z API hurtowni.

Body (JSON)

Pole	Typ	Opis
connectionId*	string	ID hurtowni

{ "upserted": 50, "total": 50 }

GET/api/wholesalers/products?connectionId={id}Sesja JWT (Bearer)

Produkty z hurtowni

Katalog zsynchronizowany z hurtowni — do importu do DropShoping.

Parametry query

Pole	Typ	Opis
connectionId	string	Filtr po hurtowni

POST/api/wholesalers/productsSesja JWT (Bearer)

Importuj produkt z hurtowni

Tworzy produkt w DropShoping ze źródłem wholesaler://. Opcjonalnie wystawia w sklepie.

Body (JSON)

Pole	Typ	Opis
wholesalerProductId*	string	ID produktu hurtowni
shopConnectionId	string	Wystaw od razu

Zamówienia

GET/api/ordersSesja JWT (Bearer)

Lista zamówień

Zamówienia ze sklepów + status auto-realizacji u hurtowni.

[
  {
    "id": "clxxx",
    "externalOrderId": "1842",
    "status": "FULFILLED",
    "totalAmount": 89.99,
    "shopConnection": { "name": "Nouviro", "platform": "NOUVIRO" },
    "supplierOrders": [
      {
        "provider": "BIGBUY",
        "status": "SUBMITTED",
        "externalOrderId": "bb_123",
        "cost": 34.2
      }
    ]
  }
]

Okazje

GET/api/opportunitiesSesja JWT (Bearer)

Lista okazji

Zapisane okazje użytkownika + aktywne ScrapeTarget i autoUrls (linki do auto-wypełnienia).

POST/api/opportunitiesSesja JWT (Bearer)

Analizuj linki lub auto-skan

Bez urls: ustaw auto:true (opcjonalnie queue:true), żeby skanować cele/trendy. Z urls: scrapuje podane linki.

Body (JSON)

Pole	Typ	Opis
urls	string[]	Lista URL produktów (opcjonalnie)
auto	boolean	true = skan automatyczny z celów i trendów
queue	boolean	true = dodaj job SCAN_OPPORTUNITIES do kolejki

{ "auto": true, "queue": true }

Ustawienia i marże

GET/api/settingsSesja JWT (Bearer)

Ustawienia konta

Pełne ustawienia użytkownika: marże, monitoring, automatyzacje (boty), trendy/popyt, platformy, powiadomienia i hurtownie.

{
  "defaultMarginPercent": 20,
  "minMarginAmount": 5,
  "monitorIntervalMinutes": 30,
  "monitorEnabled": true,
  "autoDelist": true,
  "autoUpdatePrice": true,
  "autoFulfillOrders": true,
  "simulationMode": false,

  "autoScanOpportunities": true,
  "autoRefreshTrending": true,
  "autoRefreshDemand": true,
  "opportunityScanIntervalHours": 6,
  "trendingRefreshIntervalHours": 24,
  "demandRefreshIntervalHours": 72,
  "minOpportunityMarginPercent": 20,
  "minOpportunityProfit": 10,

  "currency": "PLN",
  "demandRegion": "PL",
  "sourcePlatformIds": ["amazon", "aliexpress"],
  "comparePlatformIds": ["ceneo"],

  "enabledTrendingCategories": ["Elektronika", "Dom i ogród"],
  "customTrendingQueries": [{ "category": "Elektronika", "keyword": "powerbank 20000mah" }],
  "defaultShopConnectionId": "clxxx",
  "showDemandStats": true,
  "showComparisonStats": true,

  "notifyWebhookUrl": "https://hooks.slack.com/services/...",
  "notifyEmail": "jan@example.com",
  "notifyOnOpportunity": true,
  "notifyOnPriceChange": true,
  "notifyOnDelist": true,

  "autoImportWholesalers": false,
  "wholesalerImportIntervalHours": 24,
  "wholesalerImportCategories": ["Elektronika", "Moda"]
}

PUT/api/settingsSesja JWT (Bearer)

Aktualizuj ustawienia

Częściowa aktualizacja — wysyłasz tylko pola, które chcesz zmienić.

Body (JSON)

Pole	Typ	Opis
defaultMarginPercent	number	Domyślna marża % (0–500)
minMarginAmount	number	Minimalna marża kwotowa (np. 5 PLN)
monitorIntervalMinutes	number	Co ile minut monitoring ma sprawdzać oferty (5–1440)
monitorEnabled	boolean	Globalny przełącznik: czy monitoring jest włączony
autoDelist	boolean	Czy bot ma zdejmować oferty, gdy brak dostępności u dostawcy
autoUpdatePrice	boolean	Czy bot ma aktualizować ceny ofert wg reguł marży
autoFulfillOrders	boolean	Czy auto-realizować zamówienia u hurtowni (gdy możliwe)
simulationMode	boolean	Tryb symulacji — bot liczy i loguje, ale nie publikuje i nie zamawia
autoScanOpportunities	boolean	Czy bot ma cyklicznie skanować cele (ScrapeTarget) pod okazje
autoRefreshTrending	boolean	Czy bot ma cyklicznie odświeżać trendy (seed trending)
autoRefreshDemand	boolean	Czy bot ma cyklicznie odświeżać popyt (Google Trends)
opportunityScanIntervalHours	number	Interwał skanu okazji w godzinach (1–168)
trendingRefreshIntervalHours	number	Interwał odświeżania trendów w godzinach (1–168)
demandRefreshIntervalHours	number	Interwał odświeżania popytu w godzinach (24–720)
minOpportunityMarginPercent	number	Minimalna marża % dla okazji, aby uznać ją za wartą zapisania
minOpportunityProfit	number	Minimalny zysk kwotowy dla okazji
currency	string	Waluta w formacie ISO-4217 (np. PLN, EUR)
demandRegion	string	Region/geo dla Google Trends (np. PL, DE, US)
sourcePlatformIds	string[]	Lista platform traktowanych jako źródła zakupu (sourcing)
comparePlatformIds	string[]	Lista platform referencyjnych/porównywarek (comparison/retail)
enabledTrendingCategories	string[]	Włączone kategorie trendów (np. Elektronika)
customTrendingQueries	{ category: string; keyword: string }[]	Własne zapytania trendów per kategoria
defaultShopConnectionId	string \| null	Domyślny kanał sprzedaży do publikacji (jeśli ustawiony)
showDemandStats	boolean	Czy pokazywać statystyki popytu w panelu
showComparisonStats	boolean	Czy pokazywać statystyki porównań cen w panelu
notifyWebhookUrl	string \| null	Webhook URL dla powiadomień (Slack/Discord/Zapier). Null usuwa.
notifyEmail	string \| null	Email do powiadomień (opcjonalnie). Pusty string usuwa.
notifyOnOpportunity	boolean	Powiadom, gdy bot znajdzie okazję
notifyOnPriceChange	boolean	Powiadom, gdy monitoring zmieni cenę
notifyOnDelist	boolean	Powiadom, gdy oferta zostanie zdjęta
autoImportWholesalers	boolean	Czy bot ma cyklicznie importować produkty z hurtowni
wholesalerImportIntervalHours	number	Interwał auto-importu hurtowni w godzinach (1–168)
wholesalerImportCategories	string[]	Jakie kategorie importować z hurtowni (filtr)

{
  "simulationMode": true,
  "autoScanOpportunities": true,
  "opportunityScanIntervalHours": 6,
  "enabledTrendingCategories": ["Elektronika"],
  "customTrendingQueries": [{ "category": "Elektronika", "keyword": "powerbank 20000mah" }],
  "notifyWebhookUrl": "https://hooks.slack.com/services/..."
}

GET/api/margin-rulesSesja JWT (Bearer)

Reguły marży per kategoria

Nadpisują domyślną marżę dla produktów pasujących do categoryMatch.

POST/api/margin-rulesSesja JWT (Bearer)

Dodaj regułę marży

Tworzy regułę z priorytetem — wyższy priorytet wygrywa przy wielu dopasowaniach.

Body (JSON)

Pole	Typ	Opis
name*	string	Nazwa reguły
categoryMatch	string	Fragment nazwy kategorii (np. elektronika)
marginPercent*	number	Marża %
priority	number	Wyższy = ważniejszy

Monitor

GET/api/monitorSesja JWT (Bearer)

Logi monitora

Historia aktualizacji cen, zdejmowań i błędów synchronizacji.

POST/api/monitorSesja JWT (Bearer)

Uruchom monitoring ręcznie

Sprawdza wszystkie aktywne oferty — ceny i dostępność u dostawcy.

{ "processed": 12, "results": [...] }

Automatyzacja (boty)

POST/api/automationSesja JWT (Bearer)

Kolejkuj job automatyzacji

Dodaje zadanie do kolejki workera. Domyślnie RUN_AUTOMATION, ale można wskazać konkretny typ (np. SCAN_OPPORTUNITIES).

Body (JSON)

Pole	Typ	Opis
type	JobType	Opcjonalnie: RUN_AUTOMATION \| REFRESH_TRENDING \| REFRESH_DEMAND \| SCAN_OPPORTUNITIES \| IMPORT_WHOLESALERS

{ "type": "SCAN_OPPORTUNITIES" }

{ "queued": true, "jobId": "clxxx" }

GET/api/automation/statusSesja JWT (Bearer)

Status workera i botów

Zbiorczy status automatyzacji: heartbeat workera, liczniki, ostatnie uruchomienia oraz health scrapera i sygnał czy Google Trends działa.

GET/api/automation/logs?limit={n}Sesja JWT (Bearer)

Logi automatyzacji (historia botów)

Ostatnie zdarzenia botów (scan, refresh, notify, błędy).

Parametry query

Pole	Typ	Opis
limit	number	Limit wpisów (max 200)

GET/api/scrape-targetsSesja JWT (Bearer)

Lista celów skanowania

Zapisane cele do auto-skana: frazy lub URL.

POST/api/scrape-targetsSesja JWT (Bearer)

Dodaj cel skanowania

Dodaje ScrapeTarget dla botów (fraza lub URL).

Body (JSON)

Pole	Typ	Opis
name*	string	Nazwa celu
platform*	string	ID platformy (np. aliexpress)
baseUrl*	string	Bazowy URL albo URL produktu
searchQuery	string	Fraza wyszukiwania (opcjonalnie)
isActive	boolean	Czy aktywny

PATCH/api/scrape-targetsSesja JWT (Bearer)

Aktualizuj cel skanowania

Aktualizuje ScrapeTarget (włącz/wyłącz, zmień frazę/URL).

Body (JSON)

Pole	Typ	Opis
id*	string	ID celu
name	string	Nowa nazwa
baseUrl	string	URL
searchQuery	string	Fraza
isActive	boolean	Aktywny

DELETE/api/scrape-targets?id={id}Sesja JWT (Bearer)

Usuń cel skanowania

Usuwa ScrapeTarget po ID.

Parametry query

Pole	Typ	Opis
id*	string	ID celu

{ "success": true }

GET/api/trending?limit={n}&refresh={0|1}Publiczne

Trendy — lista

Zwraca trending products do dashboardu. Jeśli użytkownik jest zalogowany, uwzględnia jego preferencje platform i ustawienia.

Parametry query

Pole	Typ	Opis
limit	number	Ile pozycji zwrócić (max 20)
refresh	0\|1	1 = wymuś odświeżenie trendów przed zwróceniem

GET

/api/trending/demand?range={3m|6m|12m|24m}&from={YYYY-MM-DD}&to={YYYY-MM-DD}&category={name}&productId={id}&refresh={0|1}&forecastMonth={1-12}

Publiczne

Popyt — analityka (Google Trends)

Zwraca punkty popytu, metryki oraz prognozę sezonową (monthlyForecast): które produkty historycznie najlepiej sprzedają się w wybranym miesiącu kalendarzowym.

Parametry query

Pole	Typ	Opis
range	string	Zakres danych (np. 3m, 6m, 12m, 24m)
from	string	Data od (YYYY-MM-DD), opcjonalnie
to	string	Data do (YYYY-MM-DD), opcjonalnie
category	string	Filtr po kategorii (opcjonalnie)
productId	string	ID produktu (opcjonalnie)
refresh	0\|1	1 = wymuś odświeżenie popytu przed zwróceniem
forecastMonth	number	Miesiąc 1–12 do prognozy „co sprzedawać” (domyślnie bieżący miesiąc)

POST/api/trending/demandPubliczne

Popyt — odśwież

Wymusza odświeżenie popytu (Google Trends) dla produktów w bazie.

{ "refreshed": 12 }

Joby (kolejka)

GET/api/jobs?status={status}&type={type}&limit={n}Sesja JWT (Bearer)

Lista jobów (kolejka)

Zwraca joby użytkownika (kolejka wykonywana przez workera).

Parametry query

Pole	Typ	Opis
status	JobStatus	Filtr statusu (opcjonalnie)
type	JobType	Filtr typu (opcjonalnie)
limit	number	Limit (max 200)

PATCH/api/jobsSesja JWT (Bearer)

Akcja na jobie (retry/cancel)

Pozwala anulować job albo ponowić (ustawia status na QUEUED).

Body (JSON)

Pole	Typ	Opis
id*	string	ID joba
action*	string	cancel lub retry

{ "id": "clxxx", "action": "retry" }

{ "success": true }

Import do katalogu

POST/api/catalog/importSesja JWT (Bearer)

Import trendu/okazji do katalogu

Tworzy produkt w katalogu na podstawie okazji lub trendu (z deduplikacją po sourceUrl). Opcjonalnie wystawia w domyślnym sklepie.

Body (JSON)

Pole	Typ	Opis
type*	string	opportunity lub trending
id*	string	ID okazji lub ID trendu
shopConnectionId	string	Wystaw w konkretnym sklepie (opcjonalnie)

{ "type": "trending", "id": "clxxx" }

Scraper (ceny)

GET/api/scraper/healthPubliczne

Status scrapera

Sprawdza czy moduł scrapera działa (wbudowany lub zewnętrzny).

POST/api/scraper/scrapeSesja JWT (Bearer)

Scrape pojedynczego URL

Pobiera cenę/tytuł/dostępność dla URL produktu.

Body (JSON)

Pole	Typ	Opis
url*	string	URL produktu
platform	string	Platforma (opcjonalnie, auto-detect)

{ "url": "https://www.amazon.pl/dp/...", "platform": "amazon" }

POST/api/scraper/compareSesja JWT (Bearer)

Porównaj ceny z listy URL

Scrape wielu URL i zwrot najtańszego źródła + referencji rynku.

Body (JSON)

Pole	Typ	Opis
urls*	string[]	Lista URL produktów

Webhooki

Konfiguracja w Nouviro

URL webhooka w panelu Nouviro:

https://twoja-domena.pl/api/webhooks/nouviro?connectionId=ID_POŁĄCZENIA

Secret webhooka = pole apiSecret z połączenia Nouviro w DropShoping.

POST/api/webhooks/nouviro?connectionId={id}Webhook przychodzący

Webhook Nouviro (przychodzący)

Nouviro wysyła tu eventy zamówień. DropShoping przetwarza order.created i składa zamówienie u hurtowni.

Parametry query

Pole	Typ	Opis
connectionId*	string	ID połączenia Nouviro z panelu

{
  "event": "order.created",
  "timestamp": "2026-07-09T12:00:00Z",
  "data": {
    "order": {
      "id": "1842",
      "customer_name": "Jan Kowalski",
      "items": [
        { "product_id": "nv_123", "sku": "SLU-001", "quantity": 1, "price": 41.04 }
      ],
      "total": 41.04,
      "currency": "PLN"
    }
  }
}

{ "ok": true, "shopOrderId": "clxxx", "status": "FULFILLING" }

·Nagłówek X-Nouviro-Signature — weryfikacja HMAC (webhook secret z połączenia)
·Obsługiwane eventy: order.created (auto-realizacja), order.updated (ignorowany)
·product.low_stock — ignorowany (dropshipping bez własnego magazynu)

Słowniki

Statusy ofert (ListingStatus)

PENDINGOczekuje na publikację w sklepie
ACTIVEOferta aktywna
DELISTEDZdjęta (brak towaru u dostawcy)
ERRORBłąd publikacji

Statusy zamówień (OrderStatus)

RECEIVEDZamówienie odebrane
FULFILLINGRealizacja u hurtowni w toku
FULFILLEDZrealizowane u dostawcy
PARTIALCzęściowo zrealizowane
FAILEDBłąd realizacji

Statusy jobów (JobStatus)

QUEUEDW kolejce — czeka na workera
RUNNINGW trakcie — worker wykonuje joba
SUCCEEDEDZakończony sukcesem
FAILEDZakończony błędem (można retry)
CANCELLEDAnulowany

Typy jobów (JobType)

RUN_AUTOMATIONPełna tura automatyzacji (zbiorczo)
REFRESH_TRENDINGOdśwież trendy (seed trending)
REFRESH_DEMANDOdśwież popyt (Google Trends)
SCAN_OPPORTUNITIESSkanuj cele (ScrapeTarget) pod okazje
IMPORT_WHOLESALERSAuto-import produktów z hurtowni

Dokumentacja API

Wprowadzenie

Autoryzacja

Klucz API (integracje)

Sesja JWT (panel)

Webhook Nouviro

Logowanie (sesja panelu)

Rejestracja konta

Bieżący użytkownik

Lista kluczy API

Generuj klucz API

API zewnętrzne (v1)

Lista produktów

Dodaj produkt i wystaw w sklepie

Produkty

Lista produktów (panel)

Utwórz produkt (panel)

Wystaw istniejący produkt

Kanały sprzedaży

Lista kanałów sprzedaży

Podłącz sklep

Usuń połączenie sklepu

Hurtownie

Lista hurtowni

Podłącz hurtownię

Synchronizuj katalog hurtowni

Produkty z hurtowni

Importuj produkt z hurtowni

Zamówienia

Lista zamówień

Okazje

Lista okazji

Analizuj linki lub auto-skan

Ustawienia i marże

Ustawienia konta

Aktualizuj ustawienia

Reguły marży per kategoria

Dodaj regułę marży

Monitor

Logi monitora

Uruchom monitoring ręcznie

Automatyzacja (boty)

Kolejkuj job automatyzacji

Status workera i botów

Logi automatyzacji (historia botów)

Lista celów skanowania

Dodaj cel skanowania

Aktualizuj cel skanowania

Usuń cel skanowania

Trendy — lista

Trendy — odśwież

Popyt — analityka (Google Trends)

Popyt — odśwież

Joby (kolejka)

Lista jobów (kolejka)

Akcja na jobie (retry/cancel)

Import do katalogu

Import trendu/okazji do katalogu

Scraper (ceny)

Status scrapera

Scrape pojedynczego URL

Porównaj ceny z listy URL

Webhooki

Konfiguracja w Nouviro

Webhook Nouviro (przychodzący)

Słowniki