Grundlagen

Status und Auffinden: GET /status

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

Der Pfad

Methode und Pfad
GEThttps://api.posty.hu/public/v1/status
Berechtigung
Braucht keinen Scope.
operationId
getStatus

Der einzige Pfad, der auch ohne Authentifizierung antwortet. Er liefert die API-Version, die genaue Serverzeit in UTC und die absoluten Adressen aller maschinenlesbaren Dokumente: die OpenAPI-Beschreibung, die OAuth-Metadaten und den MCP-Endpunkt.

Arbeitsbereichdaten gibt er nicht zurück, und Parameter nimmt er keine. Ein Agent prüft damit am schnellsten, ob er uns erreicht und wo der Rest zu finden ist.

Anfrage

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

Antwort

Beispiel für die Form der Antwort. Das verbindliche Schema, Feld für Feld, steht im OpenAPI-Dokument.

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

Wichtig

  • Die Serverzeit steht in dieser Antwort. Wenn du planst, richte dich danach, nicht nach der Uhr deines Rechners.

Siehe auch

Fehlt etwas auf dieser Seite? Schreib eine E-Mail an [email protected] oder nutze auf der Hilfeseite das Formular.