Alapok

Állapot és felderítés: GET /status

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

Az útvonal

Metódus és útvonal
GEThttps://api.posty.hu/public/v1/status
Jogosultság
Nem kér scope-ot.
operationId
getStatus

Az egyetlen útvonal, amely hitelesítés nélkül is válaszol. Megadja az API verzióját, a szerver pontos idejét UTC-ben, és abszolút címmel minden gépi olvasásra szánt dokumentumot: az OpenAPI-leírást, az OAuth-metaadatokat és az MCP-végpontot.

Munkaterületi adatot nem ad vissza, és paramétert sem fogad. Egy ügynök ezzel tudja a leggyorsabban eldönteni, hogy elér-e minket, és hol keresse a többit.

Kérés

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

Válasz

Példa a válasz alakjára. A mezőnkénti, kötelező érvényű sémát az OpenAPI dokumentum tartalmazza.

{
  "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" }
}

Fontos

  • A szerver idejét ez a válasz adja meg. Ha ütemezel, ehhez igazodj, ne a saját géped órájához.

Kapcsolódó

Hiányzik valami erről az oldalról? Írj a [email protected] címre, vagy használd a Segítség oldal űrlapját.