Pre vývojárov

Zažiadanie o registráciu webového obchodu

Neváhaje nás kontaktovať prostredníctvom našej stránky.

Zobrazenie obalov Repetito v nákupnom košíku

V nákupnom košíku sa zobrazí možnosť výberu vratného obalu Repetito.

Zobrazenie týchto údajov je povinné!

názov	Znovupoužiteľný obal REPETITO
krátky popis	Pomôžte nám znížiť množstvo odpadu z online nákupov.
odkaz na službu	Čo je znovupoužiteľný obal?

Vygenerovanie prístupového kľúča

V administračnom rozhraní v sekcii Api kľúče si vytvoríte prístupový kľúč, ktorý Vám umožní prístup do API.

Implementácia API

Do svojho webového obchodu implementujete volanie na HTTP API pri vytvorení objednávky.
Dokumentáciu vo formáte OpenAPI nájdete tu.

POST https://test.api.repetito.sk/orders

Typ	Názov	Popis
header	x-api-key	API kľúč vygenerovaný v klientskej časti portálu.

Request body

application/json

{
  "orderNumber": "string - required - max(64)",
  "emailAddress": "string - required - max(256)",
  "phoneNumber": "string - max(64)",
  "billingAddress": {
    "street": "string - max(256)",
    "town": "string - max(256)",
    "postCode": "string - max(256)",
    "country": "string - max(256)"
  },
  "shippingAddress": {
    "street": "string - max(256)",
    "town": "string - max(256)",
    "postCode": "string - max(256)",
    "country": "string - max(256)"
  },
  "timeCreated": "datetime - ISO 8601"
}

Responses

200 Success

application/json

{
  "id": "string"
}

400 Bad Request

application/json

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": ["string"],
    "additionalProp2": ["string"],
    "additionalProp3": ["string"]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

401 Unauthorized

application/json

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

500 Server Error

application/json

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

Hlásenie stavu integrácie (voliteľné)

Váš plugin alebo integrácia môže pravidelne hlásiť svoj stav, verziu a telemetriu. Toto API je voliteľné, ale odporúčané pre lepšiu monitorovateľnosť a diagnostiku.

Odporúčanie: Volajte tento endpoint:

Pri inicializácii pluginu/integrácie
Po každej úspešne odoslanej objednávke
Pri výskyte chyby
Pravidelne (napr. každých 24 hodín) ako heartbeat

POST https://test.api.repetito.sk/integration/status

Typ	Názov	Popis
header	x-api-key	API kľúč vygenerovaný v klientskej časti portálu.

Request body

application/json

{
  "platformType": "wordpress | prestashop | shoptet | shopify | custom - required",
  "version": "string - required - max(64)",
  "lastOrderSent": "datetime - optional - ISO 8601",
  "lastError": "string - optional - max(2048)",
  "metadata": "string - optional - JSON format"
}

platformType: Typ platformy vášho obchodu (wordpress, prestashop, shoptet, shopify, alebo custom)

version: Verzia vášho pluginu alebo integrácie (napr. "1.2.3")

lastOrderSent: Timestamp poslednej úspešne odoslanej objednávky (ak práve odosielate objednávku)

lastError: Popis poslednej chyby, ak nastala

metadata: Doplnkové informácie vo formáte JSON (napr. konfigurácia, prostredie, debug info)

Responses

200 Success

application/json

{}

400 Bad Request

application/json

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": ["string"],
    "additionalProp2": ["string"],
    "additionalProp3": ["string"]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

401 Unauthorized

application/json

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

500 Server Error

application/json

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}