ActWerk API v1

Authentifizierung

Jede Anfrage trägt den API-Key als Bearer-Token. Keys sind organisationsgebunden und jederzeit widerrufbar.

Authorization: Bearer aw_live_...

POST /api/v1/classify

Ordnet einen Inhalt automatisiert nach dem versionierten Regelwerk ein und legt den Registereintrag samt Audit-Log an.

curl -X POST https://actwerk.com/api/v1/classify \
  -H "Authorization: Bearer aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "<mandanten-uuid>",
    "content_type": "bild",
    "channel": "Instagram",
    "ai_tool": "midjourney",
    "ai_involvement": "vollstaendig_ki",
    "beschreibung": "Fotorealistisches Produktbild eines Sneakers, komplett KI-generiert."
  }'

content_type: bild · text · video_kurz · video_lang · audio · chatbot
ai_involvement: vollstaendig_ki · ki_assistiert · unklar
Optional: editorial_reviewer_name, editorial_review_scope, c2pa_detected, published_at (ISO 8601)

Antwort:

{
  "content_item_id": "…",
  "classification": {
    "kennzeichnungspflichtig": true,
    "label_text": "KI-generiert – …",
    "classification_result": "…",
    "begruendung": "…",
    "is_deepfake": true,
    "public_interest": false,
    "artistic_exception": false,
    "hinweis_pruefung_noetig": false
  },
  "regelwerk_version": "…",
  "prompt_version": "v1"
}

GET /api/v1/register

Liest Registereinträge der Organisation, optional je Mandant.

curl "https://actwerk.com/api/v1/register?client_id=<mandanten-uuid>&limit=50" \
  -H "Authorization: Bearer aw_live_..."

Limits & Fehler

• Rate-Limit: 30 Einordnungen pro Minute und Organisation (HTTP 429)
• 401: Key fehlt, ungültig oder widerrufen
• 403: Paket ohne API-Zugang
• 400: Eingabe unvollständig — Details im Feld details