API documentation

#!/usr/bin/env bash
# Requires curl 7.76+ and jq; first: export EQUALDOX_API_KEY="eqx_…"
set -euo pipefail
BASE="https://equaldox.de/api/v1"
AUTH="Authorization: Bearer $EQUALDOX_API_KEY"
FILE="annual-report-2026.pdf"
IDEM_KEY="annual-report-2026-$(date +%Y%m%d%H%M%S)"         # your own ID for this upload
NAME=$(jq -rn --arg f "$(basename "$FILE")" '$f|@uri')    # percent-encode the file name

# 1. Upload; after a lost connection, repeat the same request with the same IDEM_KEY
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. Poll until job.status is DONE or FAILED
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. Download the result (--fail never writes an error response into the file)
if [ "$(jq -r '.job.result_available' <<< "$JOB")" = true ]; then
  curl -sS --fail -o "${FILE%.pdf}_accessible.pdf" "$BASE/jobs/$JOB_ID/result" -H "$AUTH"
else
  jq '.job.diagnostics.failure' <<< "$JOB"   # FAILED: error_code and action
fi

# 4. Optional: delete the job and its documents now (otherwise after 7 days)
curl -sS --fail-with-body -X DELETE "$BASE/jobs/$JOB_ID" -H "$AUTH"