Wiresphere REST API

Parametre hlavičky

Request Body (application/json)

{
  "username": "meno-pouzivatela",
  "password": "heslo"
}

Odpoveď

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Hlavičky

Parametre dopytu

Odpoveď (200)

{
  "totalElements": 42,
  "totalPages": 5,
  "size": 10,
  "number": 0,
  "first": true,
  "last": false,
  "content": [
    {
      "base": { /* Základné údaje produktu */ },
      "additional": { /* Dodatočné údaje */ }
    }
  ]
}

Parametre cesty

Odpoveď (200) — ProductDataDTO

{
  "base": { /* Základné údaje produktu (názov, SKU, cena atď.) */ },
  "additional": { /* Rozšírené polia */ }
}

Request Body (application/json) — ProductDataDTO

{
  "base": {
    // Povinné polia a údaje produktu (názov, SKU, cena, status atď.)
  },
  "additional": {
    // Voliteľné dodatočné polia
  }
}

Odpoveď

Request Body (application/json)

["produktId1", "produktId2"]

Odpoveď

Vracia všetky zaregistrované hromadné operácie vrátane schém ich parametrov.

Odpoveď (200) — pole ProductOperationRegistrationDTO

[{
  "operationId": "set-status",
  "description": "Nastaví status produktov",
  "parameterTypes": { "status": "string" },
  "previewProperties": ["status"]
}]

Simuluje hromadnú operáciu a zobrazuje stav pred/po — bez uloženia údajov.

Request Body

{
  "operationId": "set-status",
  "parameters": { "status": "ACTIVE" },
  "confirmAll": false
}

Vykonáva hromadnú operáciu na filtrovaných produktoch. Trvalo mení údaje.

Parametre dopytu

Request Body

{
  "operationId": "set-status",
  "parameters": { "status": "INACTIVE" }
}

Polia filtrov (parameter f)

Polia triedenia (parameter o)

createdAt, docId, payload.netTotalPrice, payload.grossTotalPrice, payload.customer.name

Príklad

GET /api/v1/admin/transaction/?f=doctype::ORDER,min_createdAt::2024-01-01T00:00:00.000Z&o=createdAt::DESC&p=0&s=20
Authorization: Bearer <token>
tenant-id: moj-obchod

Parametre cesty

Parametre dopytu

Odpoveď (200)

{
  "doctype": ["ORDER", "INVOICE"],
  "payload.channel": ["online", "terminal"]
}

Parametre cesty

Parametre dopytu

Parametre cesty

Parametre dopytu

Rovnaké možnosti filtrovania a triedenia ako v administrátorskom koncovom bode, avšak bez Bearer autentifikácie. Filtruje údaje dostupné v kontexte obchodu.

Polia filtrov (parameter f)

personId, firstName, lastName, email

Odpoveď (200) — PageCrmPersonDTO

{
  "totalElements": 100,
  "content": [{
    "id": "507f1f77bcf86cd799439011",
    "firstName": "Ján",
    "lastName": "Novák",
    "email": "jan@example.com",
    "personId": "ext-123",
    "addresses": [],
    "communications": [],
    "organisations": [],
    "types": []
  }]
}

Parametre cesty

Request Body (application/json) — PersonDTO

{
  "firstName": "Ján",
  "lastName": "Novák",
  "email": "jan@example.com",
  "salutation": "Pán",
  "title": "dr",
  "personId": "externe-id-123",
  "addresses": [{
    "street": "Ukážková",
    "streetNumber": "1",
    "zipCode": "811 01",
    "city": "Bratislava",
    "country": "SK",
    "type": "MAIN"
  }],
  "communications": [{
    "type": "PHONE",
    "value": "+48 123 456 789"
  }],
  "types": []
}

Rovnaké request body ako pri POST. Úplné nahradenie záznamu.

Request Body — RelationDeltaDTO

{
  "add": ["orgId1", "orgId2"],
  "remove": ["staraOrgId"]
}

Odpoveď (200) — OkDTO

{ "ok": true }

Request Body

["id1", "id2", "id3"]

Polia filtrov

name (vyhľadávanie podreťazca)

Odpoveď (200) — PageCrmOrganisationDTO

{
  "totalElements": 10,
  "content": [{
    "id": "...",
    "name": "Príklad s.r.o.",
    "organisationId": "externe-id",
    "addresses": [],
    "communications": [],
    "people": [],
    "types": []
  }]
}

Request Body — OrganisationDTO

{
  "name": "Príklad s.r.o.",
  "organisationId": "externe-id",
  "addresses": [],
  "communications": [],
  "types": []
}

Request Body — RelationDeltaDTO

{
  "add": ["personId1"],
  "remove": []
}

Odpoveď — PageSlug

{
  "content": [{
    "id": "507f...",
    "slug": "beton-c25-30",
    "label": "Beton C25/30",
    "objectType": "product",
    "collection": "products",
    "refId": "produktMongoId",
    "inactive": false
  }]
}

Request Body — Slug

{
  "id": "507f...",           // Uveďte pri aktualizácii
  "slug": "moj-slug",       // Segment URL (povinné)
  "collection": "products",  // Kolekcia MongoDB (povinné)
  "objectType": "product",   // "product" alebo "product-list" (povinné)
  "refId": "...",            // ID produktu (pri objectType "product")
  "fields": {                  // Filter pre "product-list"
    "category": "beton"
  },
  "defaultSort": [{ "field": "name", "direction": "asc" }],
  "context": ["main-nav"],
  "inactive": false
}

Užitočné na nájdenie slugu priradeného známemu produktu.

Parametre cesty

Parametre dopytu

Parametre dopytu

Odpoveď (200)

["main-nav", "footer", "sidebar"]

Request Body — pole ItemOrderDTO

[
  { "sku": "SKU-001", "categoryId": "catId", "order": 0 },
  { "sku": "SKU-002", "categoryId": "catId", "order": 1 }
]

Request Body — NavigationUpdateDTO

{
  "slugId": "slugMongoId",
  "navigationNames": ["main-nav", "footer"]
}

Parametre cesty

Request Body — Setting

{
  "key": "kluc-nastavenia",
  "public": {
    // Verejne dostupné nastavenia
    "theme": "dark"
  },
  "private": {
    // Dostupné len pre autentifikované požiadavky
    "apiKey": "secret"
  }
}

Parametre dopytu

Požiadavka ako multipart/form-data s poľom file.

Content-Type: multipart/form-data

file: [binary data]

Odpoveď (200)

{ "publishableKey": "pk_live_..." }

Vracia aktuálny stav platieb obchodu.

Hlavičky

Odpoveď (200) — WebhookTestStatusDTO

{
  "sandbox": {
    "mode": "SANDBOX",
    "passed": true,
    "ranAt": "2024-01-15T10:30:00Z",
    "durationMs": 234,
    "pending": false
  },
  "production": { /* analogicky */ }
}

Parametre cesty

Request Body (multipart)

Content-Type: application/json
file: [binary — súbor CSV alebo JSON]

Odpoveď (200) — UploadResponse

{
  "success": true,
  "importCount": 42
}

Parametre cesty

Odpoveď

Binárny súbor (string format: binary)