Rechtstipp oder Blogartikel erstellen
Generiert aus einem Thema einen recherchierten, SEO-tauglichen Artikel
(österreichisches oder Schweizer Recht, je nach land), speichert
ihn im Verlauf des Anwalts und gibt ihn inkl. id zurück. Die id
verwendest du beim Feedback als target_id.
Die Paragraphen im Text sind über markdown_linked bereits als Links
eingebettet. Minimal: nur topic + land senden — filters wird
dann mit dem Land-Default gefüllt.
Dauer: die Recherche + Generierung braucht ~1 Minute — Timeout entsprechend großzügig setzen.
Auth: erfordert das WP-JWT des Anwalts (Service-Key → 403).
Authorizations
Authorization: Bearer <TOKEN>. Für den Tipp-Lebenszyklus
(/rechtstipps) ist <TOKEN> das finditoo-WP-JWT des eingeloggten
Anwalts (ein Service-Key wird hier mit 403 abgewiesen). /feedback
und /rechtstipp/options akzeptieren zusätzlich einen Service-Key
(Maschine-zu-Maschine). Behandle Tokens als Secret; niemals in
Chats/Slack teilen.
Body
Thema/Fragestellung.
"Kündigungsfristen im Mietrecht"
rechtstipp (kurz, Endkunden) oder blog (länger, Fachpublikum).
rechtstipp, blog Rechtsordnung + Wording. ISO-Code bevorzugt; Alt-Freitext
("Österreich"/"Schweiz") wird toleriert. Steuert NICHT die
Retrieval-Jurisdiktion (das macht filters.geographic). Verfügbar:
AT und CH — DE liefert 400 (Roadmap).
AT, DE, CH Retrieval-Scope (Jurisdiktion etc.). Wird weggelassen → Land-Default.
Optionaler Stichtag (YYYY-MM-DD).
"2026-07-23"
Response
Erstellter & gespeicherter Artikel (inkl. id)
Antwort von POST /rechtstipps (alle Generator-Felder PLUS
id/created_at). Die fertig verlinkten Varianten (markdown_linked,
html_linked) gibt es nur hier auf der Erstellen-Response;
markdown_tokenized + citations werden gespeichert und kommen auch
bei GET/PATCH zurück (RechtstippStored).
Tipp-ID → beim Feedback als target_id.
Generierte H1.
Artikel MIT Quellen-Markern ([§ …]).
Artikel OHNE Marker (Veröffentlichung/Kopieren).
Marker durch {{CITATION_n}} ersetzt (für granulare Integration).
Artikel mit Paragraphen bereits als [Label](URL) eingebettet — der
einfachste Weg zu verlinkten Paragraphen. Hinweis: die Auflösung
greift aktuell für AT-Quellen (RIS/EUR-Lex); bei CH bleiben Marker
derzeit überwiegend unverlinkt (Fedlex-Verlinkung in Arbeit).
Minimal-HTML (marker-frei).
HTML mit eingebetteten Paragraphen-Links.