---
title: "NaptárAI API | NaptárAI"
description: "Nyilvános REST API: 7 napos próba, önkiszolgáló kulcs a /fejleszto oldalon, értékesítés nélkül. GET pms:read, írás pms:write."
canonical: https://naptarai.hu/dokumentacio/api
source: https://naptarai.hu/dokumentacio/api.md
---

Nyilvános API

# NaptárAI API

Nyilvános REST API: 7 napos próba, önkiszolgáló kulcs a /fejleszto oldalon, értékesítés nélkül. GET pms:read, írás pms:write.

Fejlesztési dokumentáció

A termék fejlesztés alatt áll. Az oldal a tervezett működést írja le; kész harmadik fél-integrációt csak külön, egyértelmű státusz alapján tekints elérhetőnek.

## Hol él

A NaptárAI API a https://naptarai.hu/api címen válaszol, a nyilvános útvonalak /public/v1 alatt. Gépi leírás: https://naptarai.hu/openapi.json. Ugyanazokat a domainműveleteket hívja, mint a webes felület, az MCP és a stay CLI.

## Belépés, értékesítés nélkül

Regisztráció: https://naptarai.hu/regisztracio. Nincs értékesítési hívás, nincs demókérés, nincs várólista. Minden csomag 7 napos ingyenes próbával indul; a kártyát a próba elején bekéri a Stripe, a próba alatt nem terhel.

API-kulcsot magad készítesz belépés után a https://naptarai.hu/fejleszto oldalon (Fejlesztői). A /beallitasok a fiókbeállítások; a kulcsok a Fejlesztői lapon vannak. A kulcs egyszer jelenik meg, létrehozáskor.

## Ami pms:read-del megy

Ezek a GET végpontok csak pms:read hatókört kérnek. Íráshoz (POST, PUT, DELETE) pms:write kell, az alapból nincs megadva.

- GET /public/v1/properties, /properties/:id, /properties/:id/units, /units
- GET /public/v1/calendar, /rates
- GET /public/v1/reservations, /reservations/:id
- GET /public/v1/connections, /reports/summary
- GET /public/v1/messages, /messages/:id

## Kulcs nélkül

GET /public/v1/status hitelesítés nélkül válaszol: verzió, szerveróra, OpenAPI, MCP, hatókörök. Munkaterület-adatot nem ad. GET /public/v1/is-connected érvényes kulcsot kér, de külön hatókört nem.

Dokumentációs oldalak

Hiányzik valami erről az oldalról? Írj a [norbert@naptarai.hu](mailto:norbert@naptarai.hu) címre, vagy használd a [Segítség](https://naptarai.hu/segitseg) oldal űrlapját.