API

PneuSwap booking API

Veřejné JSON API pro programatickou objednávku pneuservisu s odvozem v centru Prahy. Hodí se pro flotilové správce, leasingové společnosti, agregátory služeb a interní integrace.

Endpoint

POSThttps://pneuswap.cz/api/booking

GEThttps://pneuswap.cz/api/booking (discovery, vrací katalog služeb)

Bez autentizace, rate limit 10 requestů / hodinu / IP. Pro vyšší limity nebo dedicated B2B kontrakt napište na info@pneuswap.cz.

Vstupní schéma

Pole	Typ	Povinné	Popis
`name`	string	ano	Jméno a příjmení zákazníka (max 200 znaků)
`phone`	string	ano	Telefon ve formátu +420... (max 50)
`service`	string	ano	Kód služby. Viz tabulka služeb.
`address`	string	ano	Adresa vyzvednutí v Praze (ulice, č.p., část)
`email`	string	ne	E-mail. Pokud uvedeno, slouží jako reply-to.
`date`	string	ne	Preferovaný termín ve formátu YYYY-MM-DD
`time`	string	ne	Časové okno (např. `10-12`, `14-16`)
`tires`	string	ne	`own` \| `stored` \| `buy`
`addon_myti`	boolean	ne	Přidat mytí + úklid auta (+290 Kč)
`message`	string	ne	Volná poznámka (max 5000 znaků)
`partner_ref`	string	ne	Vaše interní ID objednávky pro reconciliaci

Kódy služeb

Code	Služba	Cena
`combo`	Balíček: dovoz auta + přezutí	1 990 Kč
`prezuti`	Pouze přezutí pneumatik	1 490 Kč
`dovoz`	Pouze dovoz auta	od 990 Kč (dle vzdálenosti)
`myti`	Mytí + úklid auta	290 Kč
`storage`	Uskladnění pneumatik	890 Kč / sezóna
`pneu`	Poptávka nových pneumatik	individuálně

Ceny jsou orientační pro centrum Prahy (Praha 1, 2, 3, 7). Pro vzdálenější adresy a speciální požadavky kalkulujeme individuálně. Po přijetí objednávky se ozveme do 30 minut s potvrzeným časem a finální kalkulací.

Příklad volání

cURL

curl -X POST https://pneuswap.cz/api/booking \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jan Novák",
    "phone": "+420777123456",
    "email": "jan@example.cz",
    "service": "combo",
    "address": "Vinohradská 14, Praha 2",
    "date": "2026-05-15",
    "time": "10-12",
    "tires": "own",
    "addon_myti": true,
    "message": "Škoda Octavia, 17\" alu kola",
    "partner_ref": "INV-2026-0042"
  }'

Python

import requests

r = requests.post(
    "https://pneuswap.cz/api/booking",
    json={
        "name": "Jan Novák",
        "phone": "+420777123456",
        "service": "combo",
        "address": "Vinohradská 14, Praha 2",
        "date": "2026-05-15",
        "time": "10-12",
    },
)
r.raise_for_status()
print(r.json())

JavaScript / Node

const res = await fetch("https://pneuswap.cz/api/booking", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    name: "Jan Novák",
    phone: "+420777123456",
    service: "combo",
    address: "Vinohradská 14, Praha 2",
    date: "2026-05-15",
  }),
});
const data = await res.json();
console.log(data);

Odpověď

Úspěch (200)

{
  "ok": true,
  "booking": {
    "service": "combo",
    "service_label": "Balíček: dovoz auta + přezutí (1 990 Kč)",
    "address": "Vinohradská 14, Praha 2",
    "date": "2026-05-15",
    "time": "10-12",
    "addon_myti": true,
    "partner_ref": "INV-2026-0042",
    "received_at": "2026-05-01T17:42:00.000Z"
  },
  "next_step": "Zavoláme do 30 minut s potvrzeným časem a kalkulací dle adresy."
}

Validační chyba (400)

{
  "ok": false,
  "error": "validation_failed",
  "details": ["phone is required", "service \"foo\" is not valid"]
}

Rate limit (429)

{
  "ok": false,
  "error": "rate_limited",
  "message": "Too many requests. Try again in an hour."
}

Doporučený workflow pro B2B

Pro každou objednávku posílejte vlastní partner_ref - usnadňuje reconciliaci
Po vytvoření zavoláme zákazníkovi (pole phone) a potvrdíme termín
Při převzetí vozu podepisujeme předávací protokol (ke stažení)
Fakturace standardně 14 dní, na vyžádání úhrada předem

Kontakt

Pro B2B partnerství, vyšší rate limity, white-label řešení nebo integrační podporu napište na info@pneuswap.cz nebo volejte +420 775 654 443.