Plantapont
Fejlesztőknek – gépi interfészek
A Plantapont webshop gépi interfészeket kínál AI-ügynökök, ajánló- és keresőrendszerek, valamint integrációk számára. A REST API (api.php) és a feedek csak olvashatók, és csak nyilvános adatot adnak (név, leírás, ár, elérhetőség, üzletek). Rendelni az mcp.php checkout tool-jaival vagy az acp.php-n lehet, kizárólag nem-kártyás fizetéssel; a rendelést leadó ügynök a saját rendelése adatait látja, másét nem.
API és ügynökök
-
OpenAPI 3.1 specifikáció /.well-known/openapi.json
Gépi API-leírás (ChatGPT Actions, GPT-k, Cursor, Copilot, Claude ezt tudja automatikusan bekötni).
-
MCP szerver /mcp.php
Model Context Protocol végpont (JSON-RPC 2.0 / Streamable HTTP). Read tool-ok + írható checkout tool-ok (create_checkout_session, complete_checkout, order_status, cancel_order).
-
Agentic checkout /acp.php
Írható rendelés-leadás AI-ügynöknek, NEM-kártyás fizetéssel (bolti/átutalás/utánvét). create_session → complete_session → (e-mailes megerősítés a vásárlótól) → order_status; lemondás: cancel_order. Online (kártyás) fizetés nincs. Korlát: 5 véglegesítés / IP / óra, 3 / e-mail / 24 óra.
-
API belépő (index) /api.php
A csak-olvasható JSON API végpontjainak leírása.
-
Termékek (lista) /api.php?resource=products&limit=100&offset=0
Publikus termékek lapozva.
-
Egy termék /api.php?resource=product&id=1
Egy termék publikus adatai.
-
Üzletek /api.php?resource=stores
A Plantapont üzletek elérhetőségei.
-
Árajánlat (quote, POST) /api.php?resource=quote
Állapotmentes kosár-validáció. POST JSON: {"items":[{"id":1,"quantity":2}]} — nem tárol, nem fizet.
Termékfeedek
-
Natív termékfeed (JSON) /feed.php
Teljes publikus katalógus JSON-ban, mértékegységgel és egységárral.
-
ACP feed (OpenAI/Stripe) /feed.php?format=acp
Agentic Commerce Protocol formátumú termékfeed.
-
CSV feed /feed.php?format=csv
Import-barát CSV (Stripe/Merchant).
-
Google Shopping feed /gfeed.php
RSS 2.0 (g: namespace) Merchant feed.
Felfedezés és tartalomtérkép
-
Agentic commerce discovery /.well-known/agentic-commerce.json
Képesség- és végponttérkép ügynököknek.
-
llms.txt /llms.txt
AI-barát tartalomtérkép a fontos oldalakról.
-
Sitemap /sitemap.xml
A bejárható URL-ek listája.
Fizetés és agentic commerce
A katalógus, a feedek és az árajánlat (quote) gépi módon elérhetők. Ügynök valós rendelést is leadhat az MCP szerveren vagy az acp.php-n, kizárólag nem-kártyás fizetéssel (fizetés a boltban, átutalás vagy utánvét). Online kártyás fizetés ügynöknek nincs – ahhoz fizetési szolgáltató (PSP) integráció kell; kártyával a vásárló maga fizethet a webshop checkoutján. A részletek a discovery dokumentumban. Az árak és a készlet üzletenként eltérhetnek; a feed/API a nyilvános alapárat adja.