Client-API

Prüfen Sie Texte programmgesteuert — dieselbe dreischichtige Engine, alle Scan-Tiefen, jede freigeschaltete Sprache. Prüfungen verbrauchen die Credits Ihrer Organisation genau wie Scans in der App und erscheinen in Ihrem Scan-Verlauf.

Authentifizierung

Organisations-Administratoren erstellen API-Schlüssel unter Organisation → API-Schlüssel. Das Secret (vc_…) wird nur einmal angezeigt. Senden Sie es bei jeder Anfrage mit:

X-API-Key: vc_your_key_here
# or
Authorization: Bearer vc_your_key_here

Prüfung absenden

POST /api/public/v1/reviews — bis zu 100 Texte pro Aufruf. Mit wait_seconds erhalten Sie die Ergebnisse in einer einzigen Anfrage (empfohlen für fast und standard); andernfalls fragen Sie die zurückgegebene URL ab.

curl -X POST https://vericlaim.eu/api/public/v1/reviews \
  -H "X-API-Key: vc_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": [
      {"id": "sku-123", "content": "Unser Detox-Tee stärkt das Immunsystem."},
      {"id": "sku-124", "content": "Ein wohltuender Kräutertee für kalte Abende."}
    ],
    "language": "de",
    "depth": "standard",
    "include_rewrites": false,
    "wait_seconds": 30
  }'

Antwort (gekürzt):

{
  "review_id": "3f6f…",
  "status": "completed",
  "credits_charged": 20,
  "poll_url": "/api/public/v1/reviews/3f6f…",
  "items": [
    {
      "id": "sku-123",
      "status": "violation",
      "risk_score": 0.9,
      "findings": [
        {
          "classification": "violation",
          "flagged_text": "Detox",
          "violated_regulation": "OLG Hamm 4 U 22/17",
          "suggested_replacement": null,
          "reasoning": "…"
        }
      ]
    },
    { "id": "sku-124", "status": "clean", "findings": [] }
  ]
}

Tiefen & Credits

`depth`	Layer	Credits / Text
fast	Stichwörter & Regex	5
standard	+ KI-Klassifikation	10
advanced	+ Belege bei Auffälligkeiten	15
deep	+ Belege für jeden Befund	20

include_rewrites: true kostet zusätzlich 5 Credits pro Text — für Texte, die sich als konform erweisen, wird dieser Aufschlag automatisch erstattet. Bei nicht ausreichendem Guthaben wird HTTP 402 mit {"error": "insufficient_credits", "balance": …, "required": …} zurückgegeben.

Weitere Endpunkte

GET /api/public/v1/reviews/{id} — Status + Befunde (so lange abfragen, bis status den Wert completed hat).
GET /api/public/v1/languages — die von Ihrem Administrator freigeschalteten Sprachen, mit Abdeckung je Sprache (siehe Sprachen).
GET /api/public/v1/balance — aktuelles Credit-Guthaben + Preismatrix.

Fehler & Limits

401 — Schlüssel fehlt, ist ungültig oder wurde widerrufen.
400 — nicht unterstützte oder vom Administrator deaktivierte Sprache.
402 — nicht genügend Credits (strukturierte Antwort).
422 — Validierungsfehler (leere Texte, ungültige Tiefe …).
429 — Ratenlimit erreicht (30 Prüfungen/Min., 120 Abfragen/Min.).
Max. 100 Texte pro Prüfung, 50.000 Zeichen pro Text.

Die Ergebnisse sind eine automatisierte Vorprüfung — sie unterstützen die Prüfung durch eine qualifizierte Rechtsberatung, ersetzen sie aber nicht.