API-Dokumentation

#!/usr/bin/env bash
# Voraussetzungen: curl 7.76+ und jq; vorher: export EQUALDOX_API_KEY="eqx_…"
set -euo pipefail
BASE="https://equaldox.de/api/v1"
AUTH="Authorization: Bearer $EQUALDOX_API_KEY"
FILE="jahresbericht-2026.pdf"
IDEM_KEY="jahresbericht-2026-$(date +%Y%m%d%H%M%S)"         # Ihre eigene ID für diesen Upload
NAME=$(jq -rn --arg f "$(basename "$FILE")" '$f|@uri')    # Dateiname URL-kodieren

# 1. Hochladen; nach einem Verbindungsabbruch dieselbe Anfrage mit demselben IDEM_KEY wiederholen
JOB=$(curl -sS --fail-with-body -X POST "$BASE/jobs" -H "$AUTH" \
  -H "Content-Type: application/pdf" \
  -H "X-Upload-Filename: $NAME" \
  -H "Idempotency-Key: $IDEM_KEY" \
  --data-binary "@$FILE") || { echo "$JOB" >&2; exit 1; }
JOB_ID=$(jq -r '.job.id' <<< "$JOB")

# 2. Status abfragen, bis job.status DONE oder FAILED ist
while :; do
  JOB=$(curl -sS --fail-with-body "$BASE/jobs/$JOB_ID" -H "$AUTH") || { echo "$JOB" >&2; exit 1; }
  STATUS=$(jq -r '.job.status' <<< "$JOB")
  echo "Status: $STATUS"
  case "$STATUS" in DONE|FAILED) break ;; esac
  sleep 10
done

# 3. Ergebnis herunterladen (--fail schreibt keine Fehlerantwort in die Datei)
if [ "$(jq -r '.job.result_available' <<< "$JOB")" = true ]; then
  curl -sS --fail -o "${FILE%.pdf}_barrierefrei.pdf" "$BASE/jobs/$JOB_ID/result" -H "$AUTH"
else
  jq '.job.diagnostics.failure' <<< "$JOB"   # FAILED: error_code und action
fi

# 4. Optional: Auftrag und Dokumente sofort löschen (sonst nach 7 Tagen)
curl -sS --fail-with-body -X DELETE "$BASE/jobs/$JOB_ID" -H "$AUTH"