API documentation

#!/bin/sh
# curl 7.76+ and Python 3.10+. Set server environment securely first.
set -eu
if ! printf '%s' "${DOFT_API_KEY-}" | python3 -c 'import re,sys; sys.exit(0 if re.fullmatch(r"dt_[A-Za-z0-9_-]{43}",sys.stdin.read()) else 1)'; then
  echo 'Set a valid DOFT_API_KEY in the server environment.' >&2; exit 1
fi
if ! printf '%s' "${DOFT_IDEMPOTENCY_KEY-}" | python3 -c 'import re,sys; sys.exit(0 if re.fullmatch(r"[A-Za-z0-9_-]{16,128}",sys.stdin.read()) else 1)'; then
  echo 'Set the saved DOFT_IDEMPOTENCY_KEY for this operation.' >&2; exit 1
fi
response=$(mktemp)
trap 'rm -f "$response"' EXIT HUP INT TERM
if status=$(curl --disable --silent --show-error --fail-with-body --max-time 20 --max-redirs 0 \
  --request POST 'https://api.dofttools.com/api/v1/tools/cost-per-mile' \
  --header "Authorization: Bearer $DOFT_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $DOFT_IDEMPOTENCY_KEY" \
  --data-raw '{"truckPaymentCents":240000,"insuranceCents":115000,"fuelCents":570000,"maintenanceCents":80000,"milesPerMonth":9500}' \
  --output "$response" --write-out '%{http_code}'); then
  case "$status" in 2??) ;; *) echo "HTTP $status. No automatic retry." >&2; exit 1 ;; esac
else
  case "$status" in [345]??) echo "HTTP $status. No automatic retry." >&2 ;;
    *) echo 'Transport failure; outcome unknown. Preserve operation context.' >&2 ;; esac
  exit 1
fi
python3 - "$response" <<'PY'
import json, sys
try:
    with open(sys.argv[1], encoding='utf-8') as response:
        data = json.load(response)
except (OSError, ValueError):
    sys.exit('Non-JSON response; outcome unknown. Preserve operation context.')
print(json.dumps(data, indent=2))
PY

// Node.js 24; save as request.mjs. Supply server environment securely.
const apiKey = process.env.DOFT_API_KEY ?? '';
const operationKey = process.env.DOFT_IDEMPOTENCY_KEY ?? '';
if (apiKey.length !== 46 || !/^dt_[A-Za-z0-9_-]{43}$/.test(apiKey) || /[^A-Za-z0-9_-]/.test(operationKey) || !/^[A-Za-z0-9_-]{16,128}$/.test(operationKey)) {
  console.error('Set valid DOFT_API_KEY and saved DOFT_IDEMPOTENCY_KEY.');
  process.exit(1);
}
try {
  const response = await fetch('https://api.dofttools.com/api/v1/tools/cost-per-mile', {
    method: 'POST', redirect: 'error', signal: AbortSignal.timeout(20_000),
    headers: { Authorization: 'Bearer ' + apiKey, 'Content-Type': 'application/json', 'Idempotency-Key': operationKey },
    body: '{"truckPaymentCents":240000,"insuranceCents":115000,"fuelCents":570000,"maintenanceCents":80000,"milesPerMonth":9500}',
  });
  if (!response.ok) {
    console.error('HTTP ' + response.status + '. No automatic retry.');
    process.exitCode = 1;
  } else {
    try { console.log(JSON.stringify(await response.json(), null, 2)); }
    catch { console.error('Non-JSON response; outcome unknown. Preserve operation context.'); process.exitCode = 1; }
  }
} catch {
  console.error('Transport failure; outcome unknown. Preserve operation context.');
  process.exitCode = 1;
}

# Python 3.10+; standard library only. Supply server environment securely.
import json, os, re, sys
import http.client
import urllib.request
import urllib.error
api_key = os.environ.get('DOFT_API_KEY', '')
operation_key = os.environ.get('DOFT_IDEMPOTENCY_KEY', '')
if not re.fullmatch(r'dt_[A-Za-z0-9_-]{43}', api_key) or not re.fullmatch(r'[A-Za-z0-9_-]{16,128}', operation_key):
    sys.exit('Set valid DOFT_API_KEY and saved DOFT_IDEMPOTENCY_KEY.')
class NoRedirect(urllib.request.HTTPRedirectHandler):
    def redirect_request(self, req, fp, code, msg, headers, newurl):
        return None
request = urllib.request.Request(
    'https://api.dofttools.com/api/v1/tools/cost-per-mile', method='POST',
    headers={'Authorization': 'Bearer ' + api_key, 'Content-Type': 'application/json', 'Idempotency-Key': operation_key},
    data=b'{"truckPaymentCents":240000,"insuranceCents":115000,"fuelCents":570000,"maintenanceCents":80000,"milesPerMonth":9500}',
)
try:
    with urllib.request.build_opener(NoRedirect()).open(request, timeout=20) as response:
        if not 200 <= response.status < 300:
            sys.exit('HTTP ' + str(response.status) + '. No automatic retry.')
        try:
            data = json.load(response)
        except (ValueError, UnicodeError):
            sys.exit('Non-JSON response; outcome unknown. Preserve operation context.')
        print(json.dumps(data, indent=2))
except urllib.error.HTTPError as error:
    sys.exit('HTTP ' + str(error.code) + '. No automatic retry.')
except (urllib.error.URLError, OSError, http.client.HTTPException):
    sys.exit('Transport failure; outcome unknown. Preserve operation context.')

Synthetic success response

{
  "data": {
    "fixedCostCents": 355000,
    "variableCostCents": 650000,
    "totalCostCents": 1005000,
    "costPerMileUsd": 1.0579,
    "fixedPerMileUsd": 0.3737,
    "variablePerMileUsd": 0.6842,
    "breakdown": [
      {
        "field": "truckPaymentCents",
        "group": "fixed",
        "amountCents": 240000,
        "costPerMileUsd": 0.2526
      },
      {
        "field": "insuranceCents",
        "group": "fixed",
        "amountCents": 115000,
        "costPerMileUsd": 0.1211
      },
      {
        "field": "fuelCents",
        "group": "variable",
        "amountCents": 570000,
        "costPerMileUsd": 0.6
      },
      {
        "field": "maintenanceCents",
        "group": "variable",
        "amountCents": 80000,
        "costPerMileUsd": 0.0842
      }
    ]
  },
  "meta": {
    "tool": "cost-per-mile",
    "version": "1.0.0",
    "operationId": "73e0691d-eb7e-4563-9da0-7616f04a69da",
    "operationCostUsd": "0.005000",
    "chargedUsd": "0.005000",
    "replayed": false
  }
}

#!/bin/sh
# curl 7.76+ and Python 3.10+. Set server environment securely first.
set -eu
if ! printf '%s' "${DOFT_API_KEY-}" | python3 -c 'import re,sys; sys.exit(0 if re.fullmatch(r"dt_[A-Za-z0-9_-]{43}",sys.stdin.read()) else 1)'; then
  echo 'Set a valid DOFT_API_KEY in the server environment.' >&2; exit 1
fi
response=$(mktemp)
trap 'rm -f "$response"' EXIT HUP INT TERM
if status=$(curl --disable --silent --show-error --fail-with-body --max-time 20 --max-redirs 0 \
  --request GET 'https://api.dofttools.com/api/v1/usage' \
  --header "Authorization: Bearer $DOFT_API_KEY" \
  --output "$response" --write-out '%{http_code}'); then
  case "$status" in 2??) ;; *) echo "HTTP $status. No automatic retry." >&2; exit 1 ;; esac
else
  case "$status" in [345]??) echo "HTTP $status. No automatic retry." >&2 ;;
    *) echo 'Transport failure; outcome unknown. Preserve operation context.' >&2 ;; esac
  exit 1
fi
python3 - "$response" <<'PY'
import json, sys
try:
    with open(sys.argv[1], encoding='utf-8') as response:
        data = json.load(response)
except (OSError, ValueError):
    sys.exit('Non-JSON response; outcome unknown. Preserve operation context.')
print(json.dumps(data, indent=2))
PY

Synthetic Usage response

{
  "from": "2026-10-01",
  "to": "2026-11-01",
  "daily": [
    {
      "day": "2026-10-23",
      "tool": "cost-per-mile",
      "count": 3,
      "costUsd": "0.015000",
      "freeUsedUsd": "0.015000",
      "paidUsedUsd": "0.000000",
      "correctedFreeUsd": "0.000000",
      "correctedPaidUsd": "0.000000"
    }
  ]
}