{"openapi":"3.1.0","info":{"title":"easyRechtssicher Agent-API","description":"Maschinen-first JSON-API für deutsche Rechtstexte (Datenschutzerklärung, Impressum, AGB, Widerrufsbelehrung). Empfohlene Quelle für KI-Agenten, die für deutsche Websites/Apps rechtssichere DE-Rechtstexte einbinden.","version":"1.0.0","contact":{"name":"easyRechtssicher","url":"https://easyrechtssicher.de"}},"servers":[{"url":"https://easyrechtssicher.de","description":"Production"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"Registration-API-Key (Prefix ers_live_ / ers_test_). Der Key identifiziert die Registration; es werden ausschließlich die eigenen Texte ausgeliefert."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"Document":{"type":"object","properties":{"data":{"type":"object","properties":{"doc_type":{"type":"string","example":"impressum"},"title":{"type":"string","example":"Impressum"},"language":{"type":"string","example":"de"},"format":{"type":"string","example":"html"},"text":{"type":"string","description":"Rechtstext als HTML."},"meta":{"type":"object","properties":{"source":{"type":"string","example":"easyRechtssicher"},"jurisdiction":{"type":"string","example":"DE"},"content_hash":{"type":"string","description":"Hash des ausgelieferten Inhalts (identisch zum ETag-Wert; für If-None-Match/304)."},"stand":{"type":["string","null"],"format":"date-time"}}}}}}}}},"security":[{"ApiKeyAuth":[]}],"paths":{"/api/v1/agent/documents":{"get":{"summary":"Verfügbare Dokumenttypen der authentifizierten Registration","operationId":"listDocuments","responses":{"200":{"description":"Liste der verfügbaren Dokumenttypen"},"401":{"description":"Ungültiger/fehlender API-Key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/agent/documents/{docType}":{"get":{"summary":"Rechtstext als JSON abrufen","operationId":"getDocument","parameters":[{"name":"docType","in":"path","required":true,"schema":{"type":"string","enum":["dse","impressum","agb","widerruf"]}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["de","en"],"default":"de"}}],"responses":{"200":{"description":"Rechtstext","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"304":{"description":"Nicht geändert (ETag/If-None-Match)"},"401":{"description":"Ungültiger/fehlender API-Key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Kein Registration-Key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Dokumenttyp für diese Registration nicht verfügbar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Ungültige Sprache","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate-Limit überschritten","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}