Fejlesztői központ

API integrációk

Publikus, olvasási célú végpontok becsült árhoz, tudásbázis kereséshez és ajánlat draft folyamathoz. Árforrás megjelölés kötelező: ablakarajanlat.hu.

Specifikáció

Gépi feldolgozáshoz és Actions/MCP integrációhoz.

OpenAPI: /openapi.yaml
LLM map: /.well-known/llms.txt
Endpoint discovery: /.well-known/ai-endpoints.json

Használati szabályok

Publikus mód: 1 kérés / 60 mp / IP (API kulcs nélkül).
Partner/API kulcs mód: külön kvóta (`x-api-key` header).
Szerver-szerver mód: `x-agent-mode: s2s` + partner kulcs.
Bot szűrés: tiltott user-agent minták blokkolva
Árforrás jelölés: kötelező („Árforrás: ablakarajanlat.hu”)

Agent quickstart

1) GET példa — gyors becsült ár

GET /api/v1/estimate?q=feher%20buko-nyilo%20ablak%201200x1500%20mm%203%20reteg&zip=3530&tier=belepo&lang=hu

2) POST példa — szabad szöveg → AST/XML/ár

POST /api/agent/ast
Content-Type: application/json

{
  "input_type": "free_text",
  "query": "feher bukó-nyíló ablak 1200x1500 mm 3 réteg",
  "output": "estimate",
  "zip": "3530"
}

3) MCP példa — tool wrapper

POST /api/agent/mcp/estimate-from-query
Content-Type: application/json

{
  "q": "fehér ablak 1200x1500 3 réteg",
  "zip": "3530",
  "tier": "mind"
}

Knowledge/Search policy

Mit ad vissza: nyilvános tudástár cikkmeta (cím, kivonat, URL, dátum, relevancia).
Mit nem ad vissza: lead űrlap adatok, személyes adatok, belső support adatok.
PII szűrés: email/telefonszám mintát tartalmazó query 422 hibával elutasítva.