Za AI asistente (ChatGPT, Claude, Perplexity …) in razvijalce

Katalog 2414 rabljenih avtodelov je odprt in strojno berljiv. AI asistent lahko po zalogi išče sam in kupcu da točen odgovor s ceno, slikami in povezavo. Nakup poteka po telefonu 040 376 522.

Dostop

Avtentikacija: ni potrebna — brez prijave, brez API ključa.
CORS: odprt (Access-Control-Allow-Origin: *) za vse JSON odgovore.
Omejitve: prosimo največ ~2 zahtevka na sekundo; za cel katalog uporabite eno datoteko (/llms-full.txt ali /api/catalog.json) namesto mnogih iskanj.
Predpomnjenje: odgovori podpirajo ETag / If-None-Match (304), max-age 10 min.
MCP: lastnega MCP strežnika nimamo; API je opisan z OpenAPI 3, ki ga AI orodja (npr. ChatGPT Actions) uvozijo neposredno.

Zaloga in svežina podatkov

Katalog se sinhronizira z našo trgovino na bolha.com vsaki 2 uri. Prodani deli izginejo v največ 2 urah, novi se pojavijo v enakem času.
Vsak del v katalogu je na zalogi: "availability": "in_stock", "quantity": 1 (rabljeni deli so unikati).
Pred nakupom zalogo vseeno potrdite po telefonu 040 376 522.

Iskanje

Namen	Zahtevek
Iskanje (JSON)	`GET /api/search/?q=…&make=&model=&category=&limit=20&offset=0` ostranjevanje: `offset` ali `page` (od 1), `limit` do 100; odgovor ima `total`, `has_more` in `next`
Iskanje (HTML, brez JavaScripta)	`GET /iskanje/?q=…`
En del po šifri (enaka kot na bolha.com)	`GET /api/parts/<šifra>.json`
Znamke in modeli	`GET /api/makes.json`
Ves katalog (JSON)	`GET /api/catalog.json`
Ves katalog (besedilo, ena vrstica na del)	`GET /llms-full.txt`
Deli za model po kategoriji (HTML)	`/znamka/<znamka>/<model>/<kategorija>/`, npr. /znamka/peugeot/508/luci/

Iskalnik razume slovenske, angleške, nemške in hrvaške izraze, levo/desno, spredaj/zadaj, letnike, OEM številke in šifre oglasov. Kategorije za category: karoserija, luci, stekla-ogledala, motor, menjalnik-pogon, podvozje-vzmetenje, zavore, elektrika-elektronika, notranjost, hlajenje-ogrevanje-klima, izpuh, gorivo, platisca-pnevmatike, vozilo-po-delih, ostalo.

Primeri

Iskanje po opisu (angleško ali slovensko):

GET https://poceni-deli.com/api/search/?q=rear+left+tail+light+peugeot+508&limit=1

Iskanje po OEM številki in po modelu s kategorijo:

GET https://poceni-deli.com/api/search/?q=9678393180
GET https://poceni-deli.com/api/search/?make=peugeot&model=508&category=luci

Odgovor (skrajšano):

{
  "query": "rear left tail light peugeot 508",
  "total": 5, "offset": 0, "limit": 1, "has_more": true,
  "next": "https://poceni-deli.com/api/search/?q=rear+left+tail+light+peugeot+508&limit=1&offset=1",
  "results": [{
    "id": "16683772",
    "name": "Peugeot 508 SW 2010–2018 — zadnja leva luč",
    "title": "Peugeot 508 SW 2010-2018 ZADNJA LEVA LUČ ŽAROMET KARAVAN",
    "url": "https://poceni-deli.com/del/peugeot-508-sw-2010-2018-zadnja-leva-luc-zaromet-karavan-16683772/",
    "price_eur": 50, "price_text": "50 €",
    "condition": "used", "availability": "in_stock", "quantity": 1,
    "make": "Peugeot", "model": "508", "variant": "SW", "year_from": 2010, "year_to": 2018,
    "part": "zadnja leva luč", "side": "levo", "position": "zadaj", "oem_numbers": [],
    "name_en": "Peugeot 508 SW 2010-2018 rear left tail light",
    "images": ["https://poceni-deli.com/img/16683772/0.jpg", "…"],
    "contact_phone": "040 376 522"
  }],
  "search_page": "https://poceni-deli.com/iskanje/?q=…",
  "contact_phone": "040 376 522"
}

Polja in kakovost podatkov

name je enotno slovensko ime iz strukturiranih polj; title je izvirni naslov z bolha.com (prost zapis, lahko s tipkarskimi napakami).
price_eur je število (null = cena po dogovoru), price_text je prikaz za ljudi. DDV ni obračunan, poštnina ni vključena.
side: levo/desno (levo/desno), position: spredaj/zadaj (spredaj/zadaj), part: normalizirano ime dela.
Pokritost iz oglasov: znamka 99 %, model 96 %, letniki 80 %, motor 36 %, OEM številka 26 %, »ustreza tudi« 16 %. Kjer prodajalec podatka ni navedel, je polje prazno — ne ugibamo. Za združljivost brez OEM številke pokličite.
Več enakih naslovov pomeni več enakih kosov (npr. iz različnih vozil), vsak s svojo šifro in slikami.

Strukturirani podatki

Vsaka stran dela ima schema.org Product + Offer (cena v EUR, InStock, UsedCondition, slike, združljivo vozilo isAccessoryOrSparePartFor z letniki, OEM številka kot mpn, pravila vračila 14 dni, rok dostave). Strani modelov imajo še FAQPage, trgovina pa AutoPartsStore.

Datoteke

/llms.txt — navodila za jezikovne modele
/llms-full.txt — ves katalog, ena vrstica na del
/api/catalog.json — ves katalog v JSON
/api/openapi.json — OpenAPI 3 specifikacija
/sitemap.xml — kazalo; sitemap-parts.xml (vsi deli s slikami), sitemap-pages.xml