Základy

Stav a objevování: GET /status

Állapot és felderítés. Az egyetlen útvonal, amely kulcs nélkül is válaszol.

Cesta

Metoda a cesta
GEThttps://api.posty.hu/public/v1/status
Oprávnění
Nepotřebuje scope.
operationId
getStatus

Jediná cesta, která odpoví i bez autentizace. Vrátí verzi API, přesný čas serveru v UTC a absolutní adresy všech dokumentů určených ke strojovému čtení: popis OpenAPI, metadata OAuth a endpoint MCP.

Data pracovního prostoru nevrací a parametry nepřijímá. Agent tak nejrychleji zjistí, jestli se k nám dostane a kde hledat zbytek.

Požadavek

curl https://api.posty.hu/public/v1/status

Odpověď

Příklad tvaru odpovědi. Závazné schéma, pole po poli, je v dokumentu OpenAPI.

{
  "name": "Posty API",
  "status": "ok",
  "version": "v1",
  "time": "2026-08-31T14:07:21.689Z",
  "documentation": {
    "developers": "https://posty.hu/fejlesztok",
    "openapi": "https://api.posty.hu/docs-json",
    "openapiMirror": "https://posty.hu/openapi.json",
    "swaggerUi": "https://api.posty.hu/docs",
    "llms": "https://posty.hu/llms.txt"
  },
  "authentication": {
    "apiKey": { "header": "Authorization", "format": "psty_...", "selfServe": true },
    "oauth2": { "resource": "https://api.posty.hu/public/v1", "...": "..." },
    "signUp": "https://posty.hu/regisztracio",
    "salesContactRequired": false
  },
  "mcp": { "endpoint": "https://api.posty.hu/mcp-oauth", "transport": "streamable-http" },
  "scopes": {
    "rest": ["posts:read", "posts:draft", "posts:publish",
             "channels:read", "channels:write", "media:write", "analytics:read"],
    "mcp": ["mcp:read", "mcp:write"]
  },
  "rateLimits": { "headers": ["RateLimit-Limit", "RateLimit-Remaining",
                              "RateLimit-Reset", "RateLimit-Policy"] },
  "versioning": { "scheme": "url-path", "current": "v1" }
}

Důležité

  • Čas serveru je v této odpovědi. Když plánujete, řiďte se jím, ne hodinami vlastního počítače.

Související

Něco vám na této stránce chybí? Napište na [email protected] nebo na stránce Nápověda vyplňte formulář.