{"openapi":"3.1.0","info":{"title":"BI Trading – catalog public (read-only)","version":"1.0.0","description":"API public, doar citire, pentru asistenți AI și agenți: categorii și produse BI TRADINGS S.R.L. (țiglă metalică, tablă, accesorii, sistem pluvial Bilka), cu variante, finisaje și culori RAL. Răspunsurile sunt în limba română, prețurile în RON. Nu există plată sau comandă prin API: pentru ofertă folosiți pagina de contact. Răspunsurile sunt cache-uite 10 minute; limită orientativă 120 cereri/minut.","contact":{"name":"BI TRADINGS S.R.L.","email":"office@bitradings.ro","url":"https://bitradings.ro/contact"}},"servers":[{"url":"https://bitradings.ro"}],"externalDocs":{"description":"Rezumat pentru LLM (llms.txt)","url":"https://bitradings.ro/llms.txt"},"paths":{"/api/public/catalog":{"get":{"operationId":"listCatalog","summary":"Categorii și produse (paginat)","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"category","in":"query","description":"Slug categorie, ex. tigla-metalica, sistem-pluvial","schema":{"type":"string"}}],"responses":{"200":{"description":"Catalog","content":{"application/json":{"schema":{"type":"object","properties":{"categories":{"type":"array","items":{"type":"object"}},"products":{"type":"object","properties":{"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"},"pages":{"type":"integer"},"next":{"type":["string","null"]},"prev":{"type":["string","null"]},"items":{"type":"array","items":{"$ref":"#/components/schemas/ProductSummary"}}}}}}}}},"404":{"description":"Categoria nu există"}}}},"/api/public/products/{slug}":{"get":{"operationId":"getProduct","summary":"Detalii produs: variante (culoare, finisaj, cod RAL, imagine), specificații, documente","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"example":"clasic"}],"responses":{"200":{"description":"Produs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDetail"}}}},"301":{"description":"Slug vechi: redirecționare către adresa nouă"},"404":{"description":"Produsul nu există"}}}},"/api/public/search":{"get":{"operationId":"searchProducts","summary":"Căutare în catalog (fiecare cuvânt trebuie să apară; diacriticele sunt opționale)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","maxLength":80},"example":"tigla mat 8017"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Rezultate","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/ProductSummary"}}}}}}},"400":{"description":"Lipsește q"}}}},"/feed/catalog.json":{"get":{"operationId":"catalogFeed","summary":"Toate produsele (inclusiv cele cu preț la cerere), cu variante","responses":{"200":{"description":"Feed JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/feed/products.xml":{"get":{"operationId":"merchantFeed","summary":"Feed RSS 2.0 (Google Merchant) doar cu produsele care au preț","responses":{"200":{"description":"RSS","content":{"application/rss+xml":{"schema":{"type":"string"}}}}}}},"/llms.txt":{"get":{"operationId":"llmsTxt","summary":"Rezumat Markdown pentru LLM","responses":{"200":{"description":"Markdown","content":{"text/plain":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"ProductSummary":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"apiUrl":{"type":"string","format":"uri"},"category":{"type":["object","null"],"properties":{"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"}}},"brand":{"type":["string","null"]},"type":{"type":"string"},"typeLabel":{"type":"string"},"tagline":{"type":["string","null"]},"unit":{"type":"string","description":"mp = m², ml = metru liniar, buc = bucată"},"unitLabel":{"type":"string"},"currency":{"type":"string","enum":["RON"]},"price":{"type":["number","null"],"description":"Prețul minim afișat (cu TVA); null = preț la cerere"},"priceMax":{"type":["number","null"]},"priceLabel":{"type":"string"},"pricesIncludeVat":{"type":["boolean","null"]},"availability":{"type":"string","enum":["in_stock","on_order","out_of_stock"]},"availabilityLabel":{"type":"string"},"variantCount":{"type":"integer"},"colourCount":{"type":"integer"},"finishes":{"type":"array","items":{"type":"string"}},"image":{"type":["string","null"],"format":"uri"}}},"ProductDetail":{"allOf":[{"$ref":"#/components/schemas/ProductSummary"},{"type":"object","properties":{"sku":{"type":["string","null"]},"summary":{"type":"string"},"description":{"type":["string","null"]},"specifications":{"type":"object","additionalProperties":{"type":"string"}},"warranty":{"type":["object","null"],"properties":{"years":{"type":"integer"},"note":{"type":"string"}}},"variants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"finish":{"type":["string","null"]},"ralCode":{"type":["string","null"]},"hex":{"type":["string","null"]},"sku":{"type":["string","null"]},"price":{"type":["number","null"]},"image":{"type":["string","null"],"format":"uri"}}}},"images":{"type":"array","items":{"type":"string","format":"uri"}},"documents":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string","format":"uri"}}}},"tools":{"type":"object","properties":{"simulator":{"type":["string","null"]},"calculator":{"type":["string","null"]}}},"howToBuy":{"type":"object"}}}]}}}}