How do I make my first ASHDOCS API call?

1. Sign up and grab your sandbox key

Head to app.ashdocs.com/signup. On landing, a sandbox key (ash_test_...) is issued automatically and displayed in the dashboard.

2. Send your first request

The following curl converts a small HTML string to a PDF. Sandbox keys never bill.

curl -X POST https://www.ashdocs.com/api/v1/tools/html-to-pdf \
  -H "X-API-Key: ash_test_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "html": "<h1>Hi</h1>", "options": { "format": "A4" } }'

3. Inspect the response

The response includes job_id, status, and a signed URL under output_files[].

{
  "job_id": "job_01H...",
  "status": "completed",
  "credits_consumed": 0,
  "output_files": [
    { "url": "https://storage.ashdocs.com/...signed", "filename": "output.pdf", "size_bytes": 4231 }
  ]
}

4. Subscribe to webhooks (optional)

For async workflows, subscribe to job.completed so your app is notified as soon as a job finishes.

curl -X POST https://www.ashdocs.com/api/webhooks \
  -H "X-API-Key: ash_test_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://your.app/hook", "events": ["job.completed"] }'