Skip to main content

Quick Start

An end-to-end tour of iTechSmart in about five minutes, from your terminal, with no signup: check the platform is alive, make a real API call, watch it seal a cryptographic receipt, verify that receipt on the public ledger, then (optionally) scan your own machine with Pulse. Every command below was run and verified against the live services on 2026-07-01.

Prerequisites: curl and python3 (used only to pretty-pick JSON fields — swap in jq if you prefer). No API key is needed: the gateway’s anonymous free tier allows 100 requests/day (10 classifications). See Authentication for keys and tiers.

Step 1 — Check platform health

curl https://api.itechsmart.dev/v1/health
{"status":"operational","service":"iTechSmart API Gateway","timestamp":"2026-07-01T23:48:27.286132+00:00"}

Step 2 — Make a real API call

Classify a (pretend) incident. This is a real production endpoint: the call is processed and sealed as a ProofLink receipt on the public ledger:

curl -s -X POST https://api.itechsmart.dev/v1/classify \
  -H "Content-Type: application/json" \
  -d '{"description": "nginx container restarting in a loop after deploy"}'

The response includes a proof block:

{
  "classification": null,
  "proof": {
    "receipt_hash": "09c9e9e54972b8dc1516ef3aa8274956f59158261da9a1f3a16a0c30db81e8ea",
    "receipt_id": "09c9e9e54972b8dc",
    "hash_chained": true,
    "verify_url": "https://verify.itechsmart.dev"
  }
}

Keep the first 12 characters of receipt_hash — the ledger entry for your call is sealed (asynchronously, usually within seconds) with subject classify-<those 12 chars>.

Step 3 — Find your receipt on the public ledger

The ledger at verify.itechsmart.dev is public — no key needed. Find the entry your call just created (replace the prefix with yours):

PREFIX=09c9e9e54972   # first 12 chars of your receipt_hash
curl -s "https://verify.itechsmart.dev/api/receipts?limit=100&page=0" \
  | python3 -c "import json,sys; print(next(r['receipt_id'] for r in json.load(sys.stdin)['receipts'] if r['subject']=='classify-$PREFIX'))"
2a0f3c4b230b8cfe

Step 4 — Cryptographically verify the receipt

curl -s https://verify.itechsmart.dev/api/verify/2a0f3c4b230b8cfe

You get the full receipt: its SHA-256, the previous_hash linking it to the receipt before it, chain position, timestamp, and (for v2.0 receipts) an Ed25519 signature you can check offline. You can also just paste the ID into the search box at verify.itechsmart.dev.

Then confirm the whole chain is intact — every receipt, back to genesis:

curl -s https://verify.itechsmart.dev/api/stats
# {"total_receipts": 77191, "chain_intact": true, "breaks": 0,
#  "genesis_timestamp": "2026-05-26T18:12:53.552120+00:00", ...}

That is the whole trust model in four commands: an autonomous platform whose every action lands on a hash-chained public ledger that you just verified yourself. Details in the ProofLink API reference.

Step 5 (optional) — Scan your own machine with Pulse

curl -sSL https://app.itechsmart.dev/install.sh | bash

Pulse runs read-only security checks (firewall, open ports, pending updates, disk encryption on macOS…), grades your machine A–F, and seals its own ProofLink receipt. Direct downloads for Linux, macOS, and Windows are on the Pulse page, along with exactly what the scanner checks and what leaves your machine.

Next steps