OpenAPI 3.1 – gépi API-leírás / API specification · Rövid útmutató agenteknek / Agent guide
Árkalkulátor JavaScript nélkül, minden termékhez / HTML pricing for all products. A választási kódok és a kiszámított konfiguráció ára normál HTML-ben is olvasható.
Teljes címek szöveges olvasókhoz / Full URLs for text readers:
HTML: https://www.serverline.hu/api/calculator.php
OpenAPI: https://www.serverline.hu/api/openapi.json
Agentútmutató / Agent guide: https://www.serverline.hu/llms.txt
Terméklista / Product list: https://www.serverline.hu/api/v1/products.php
Árlekérdezési végpont / Quote endpoint: https://www.serverline.hu/api/v1/quote.php
Nyilvános, fiók és JavaScript nélkül használható árlekérdezés a honlap 14 kalkulátoros termékéhez. Ugyanazok a szerveroldali kalkulátorok és aktuális árforrások számolnak, mint a kosárban, az Excel-alapú termékeknél is.
Public, read-only pricing API. No account, cookies or JavaScript required. Fetch the product list, read each product's field codes, then request a quote. GET and JSON POST quotes use the same official calculators as the shopping cart. Field names and codes are language independent; labels and validation messages are currently Hungarian.
GET /api/v1/products.phpGET /api/v1/products.php?product_code=business_cardGET /api/v1/quote.php, a termékkóddal és minden kiválasztott mezővel.Névjegykártya mezői / Business-card fields: https://www.serverline.hu/api/v1/products.php?product_code=business_card
Példakérés teljes címe / Full example URL: https://www.serverline.hu/api/v1/quote.php?product_code=business_card&mennyiseg=100&nyomtatas=4-0&meret=90x50&karton=alapkarton&feluletnemesites=nincs&sarokkerekites=nincs&gyartasi_ido=azonnali&anyagleadas=nyomdakesz
POST /api/v1/quote.php, Content-Type: application/json. A kérés legfeljebb 16 KiB lehet. Minden, a terméknél felsorolt mezőt adj meg. A gyartasi_ido üres értéke az aktuális normál gyártást választja. Számok pozitív egészként vagy egész számot tartalmazó stringként küldhetők.
{
"product_code": "business_card",
"selections": {
"mennyiseg": 100,
"nyomtatas": "4-0",
"meret": "90x50",
"karton": "alapkarton",
"feluletnemesites": "nincs",
"sarokkerekites": "nincs",
"gyartasi_ido": "azonnali",
"anyagleadas": "nyomdakesz"
}
}
A prospektus mezői és a matrica mezői ugyanígy kérdezhetők le. A papír, méret, terjedelem, kivitel, gyártási idő és grafikai igény alapján a szerver számolja az árat. Nem kell Excel-fájlt letölteni vagy képleteket futtatni az agentben.
Az opciólista konfigurációfüggő lehetőségeket is tartalmaz: nem minden gyártási idő vagy felületnemesítés rendelhető minden kivitelhez és mennyiséghez. A kombinációt az árlekérdezés ellenőrzi; hibás kérésre hibaüzenet érkezik, becsült ár nem.
| Mező | Jelentés |
|---|---|
currency | HUF; az összegek forintban értendők. |
production_unit_price_net | Nettó gyártási darabár, a kiválasztott gyártási idővel. |
production_total_net | Teljes nettó gyártási összeg. |
graphic_fee_net | Nettó grafikai díj. |
item_total_net, vat_rate, vat_amount, item_total_gross | Nettó tételösszeg, áfakulcs százalékban, áfa és bruttó tételösszeg. |
production_time_surcharge_percent, production_time_surcharge_total_net | Ha a kalkulátor külön adja: a gyártási idő felára. Már szerepel az összegben, még egyszer nem adandó hozzá. |
labels.gyartasi_ido | A konfiguráció tényleges gyártási ideje; ezt idézd az ügyfélnek. |
selections, labels, calculated_at | Kiválasztott paraméterek, megnevezések és a kalkuláció UTC-időpontja. |
price_version | Az árforrások közös SHA-256 verziója. Bármely árforrás változásakor módosulhat; nem jelent árgaranciát. |
A lekérdezés vendég listaárat ad, szállítás és a belépéshez kötött partnerkedvezmény nélkül. A gyártási idő a gyártható állapottól indul, a házhozszállítás legalább további egy munkanap. A megjelenített ár nem rögzített ajánlat; rendelés előtt újra kell számolni. Indexelt vagy korábban idézett ár helyett mindig az élő árlekérdezést használd.
404 unknown_product: ismeretlen termék; 405 method_not_allowed: nem támogatott HTTP-metódus; 422 invalid_selection: hiányzó mező, hibás kód vagy nem rendelhető kombináció; 503 pricing_unavailable: az árképzés vagy az árforrás nem elérhető. Hiba esetén ne találj ki árat.
Az API jelenleg kizárólag árat számol. Kosártételt, rendelést, fiókot és fizetést nem hoz létre, e-mailt nem küld. A termékoldalakon a meglévő kosárfolyamat használható. Későbbi rendelési API-hoz újraszámítás, jóváhagyott rendelési összesítő és ismételt küldés elleni védelem szükséges.