{
  "name": "namensschild.io Public API",
  "description": "Die Public API für namensschild.io wird unter /v1 versioniert und bildet dieselben Kredit- und Exportregeln ab wie die Produktoberflächen. Die kanonische Maschinenbeschreibung liegt unter /openapi.json; /openapi/v1 bleibt als Kompatibilitätsalias bestehen. Zusätzliche Discovery-Artefakte werden unter /, /llms.txt und /.well-known/api-catalog bereitgestellt.",
  "version": "1.0.0",
  "base_url": "https://api.namensschild.io",
  "authentication": {
    "type": "bearer_api_key",
    "header": "Authorization",
    "scheme": "Bearer",
    "format": "Bearer <api_key>"
  },
  "artifacts": {
    "openapi": "https://api.namensschild.io/openapi.json",
    "legacy_openapi": "https://api.namensschild.io/openapi/v1",
    "llms": "https://api.namensschild.io/llms.txt",
    "api_catalog": "https://api.namensschild.io/.well-known/api-catalog",
    "docs": "https://docs.namenschild.io/api"
  },
  "resources": [
    {
      "method": "POST",
      "path": "/v1/generate",
      "url": "https://api.namensschild.io/v1/generate",
      "summary": "Erzeugt ein druckfertiges PDF aus einer CSV-Datei."
    },
    {
      "method": "GET",
      "path": "/v1/credits",
      "url": "https://api.namensschild.io/v1/credits",
      "summary": "Liefert verbleibendes Guthaben und Auto-Refill-Status."
    },
    {
      "method": "GET",
      "path": "/v1/templates",
      "url": "https://api.namensschild.io/v1/templates",
      "summary": "Listet verfügbare Vorlagen des authentifizierten Accounts."
    },
    {
      "method": "GET",
      "path": "/v1/templates/{id}",
      "url": "https://api.namensschild.io/v1/templates/{id}",
      "summary": "Liefert die Detailansicht einer verfügbaren Vorlage."
    },
    {
      "method": "GET",
      "path": "/v1/paper-presets",
      "url": "https://api.namensschild.io/v1/paper-presets",
      "summary": "Listet verfügbare Papierpresets des authentifizierten Accounts."
    },
    {
      "method": "GET",
      "path": "/v1/paper-presets/{id}",
      "url": "https://api.namensschild.io/v1/paper-presets/{id}",
      "summary": "Liefert die Detailansicht eines verfügbaren Papierpresets."
    },
    {
      "method": "GET",
      "path": "/v1/exports",
      "url": "https://api.namensschild.io/v1/exports",
      "summary": "Listet Exporte des authentifizierten Accounts mit Filtern und Cursor-Pagination."
    },
    {
      "method": "GET",
      "path": "/v1/exports/{id}",
      "url": "https://api.namensschild.io/v1/exports/{id}",
      "summary": "Lädt ein bereits erzeugtes PDF erneut herunter."
    }
  ]
}