Basics

Status and discovery: GET /status

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

Path

Method and path
GEThttps://api.posty.hu/public/v1/status
Authorization
No scope required.
operationId
getStatus

The only path that responds without authentication. It returns the API version, the server's exact time in UTC, and absolute URLs for every document meant for machines: the OpenAPI description, the OAuth metadata, and the MCP endpoint.

It does not return workspace data, and it takes no parameters. This is the fastest way for an agent to check that it can reach us, and where to look for the rest.

Request

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

Response

Example response structure. The OpenAPI document contains the authoritative schema for each field.

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

Important

  • This response is the source of the server's time. If you schedule, use this, not your own machine's clock.

Related

Is something missing from this page? Email [email protected] or use the form on the Help page.