Quickstart: your first run from the command line

#!/usr/bin/env bash
set -euo pipefail

BASE="https://chargerdojo.com"
AUTH="Authorization: Bearer $DOJO_KEY"

# 1. Pick a built-in sandbox connection. Several are provisioned per version (a CPO peer,
#    an eMSP peer, and a payment-terminal peer on 2.2.1 and 2.3.0), all already registered,
#    so narrow on the role you want rather than taking whichever comes back first.
CONNECTION_ID=$(curl -fsS "$BASE/api/v1/connections" -H "$AUTH" \
  | jq -r '[.data[] | select(.kind == "sandbox" and .ocpiVersion == "2.2.1"
           and .theirRole == "CPO" and .targetPersona != "PTP")][0]._id')

# 2. Start the full conformance suite and wait for the report. 55s is the maximum;
#    anything larger is clamped to it, because the proxy cuts an idle read at 60.
RUN=$(curl -sS --fail-with-body -X POST "$BASE/api/v1/testing/runs?wait=55" \
  -H "$AUTH" -H "Content-Type: application/json" \
  -d "{\"connectionId\": \"$CONNECTION_ID\"}") || {
  echo "Could not start the run: $RUN"
  exit 2
}

REPORT_ID=$(printf '%s' "$RUN" | jq -r '.data.reportId')

# 3. Poll until the run is over. A 202 means the run is still going: your wait expired,
#    not the run. It is also a 2xx, so `curl` is perfectly happy with it, and one extra
#    read is not enough either. The status in the body is the only thing that says the
#    run finished, so keep asking until it is one of the four terminal states.
while :; do
  RUN_STATUS=$(printf '%s' "$RUN" | jq -r '.data.status')
  case "$RUN_STATUS" in
    completed|failed|cancelled|interrupted) break ;;
  esac

  sleep 5
  # --retry honours the Retry-After header on a 429 and rides out a transient failure;
  # --fail-with-body makes every other non-2xx a non-zero exit with the body still readable.
  RUN=$(curl -sS --fail-with-body --retry 3 \
    "$BASE/api/v1/testing/runs/$REPORT_ID?wait=55" -H "$AUTH") || {
    echo "Could not read the run: $RUN"
    exit 2
  }
  printf '%s' "$RUN" | jq -e '.success' > /dev/null || {
    echo "The API answered something that is not a run: $RUN"
    exit 2
  }
done

# 4. Read the verdict. Over is not the same as graded: a run we cancelled or interrupted
#    carries no summary at all, and `jq` prints `null` for a summary that is not there.
SUMMARY=$(printf '%s' "$RUN" | jq '.data.summary')
if [ "$SUMMARY" = "null" ]; then
  echo "The run ended as '$RUN_STATUS' and was never graded. Run it again."
  exit 2
fi

printf '%s' "$SUMMARY" | jq .