Farpy EZPZ API

Upload a file → get a deterministic PNG result + a signed proof JSON.

Base URL

https://farpy.com/ezpz

Auth

Required on upload:

X-API-Key: <your_key>

1) Create job

POST /ezpz/upload (multipart form-data)

curl -s \
  -H "X-API-Key: YOUR_KEY_HERE" \
  -F "file=@/path/to/your/file" \
  https://farpy.com/ezpz/upload | jq

Response:

{
  "ok": true,
  "job_id": "EZPZ-abc123",
  "status": "queued",
  "proof_url": "/ezpz/proof/EZPZ-abc123.proof.json",
  "result_url": "/ezpz/result/EZPZ-abc123."
}

2) Fetch result

GET /ezpz/result/{job_id}.

curl -I https://farpy.com/ezpz/result/EZPZ-abc123.

3) Fetch proof

GET /ezpz/proof/{job_id}.proof.json

curl -s https://farpy.com/ezpz/proof/EZPZ-abc123.proof.json | jq

Proof fields:

{
  "job_id": "...",
  "input_sha256": "...",
  "output_sha256": "...",
  "output_file": "...",
  "engine": "EZPZ",
  "node": "...",
  "timestamp": "...",
  "api_key": "...",
  "signature": "..."
}

Errors

401 {"ok": false, "error": "unauthorized"}
429 {"ok": false, "error": "rate_limited"}

Rate limits

Uploads are rate-limited per API key. Reads are free.

Support

If you’re integrating this, include your job_id and proof_sha256.