Base URL
https://docify.site/api
These are hosted document and image tools, separate from the local codebase documentation CLI. Submitted documents and images are processed for the response and are not retained as uploaded files.
Choose an endpoint
Free HTML to PDF API
Generate PDF reports and certificates from HTML with Docify's free hosted API. Send JSON, choose A4 or Letter, and download the PDF without an API key.
Request fields, cURL and Node.js examples →POST /v1/imagesFree Image Optimization API
Resize, compress and convert PNG, JPEG and WebP images with Docify's free API. Send raw image bytes and select dimensions, quality and output format.
Request fields, cURL and Node.js examples →POST /v1/image-to-pdfFree Image to PDF API
Convert a PNG, JPEG or WebP image to a one-page PDF through Docify's free API. Choose A4 or Letter, orientation and margins. No API key needed.
Request fields, cURL and Node.js examples →Quick reference
| Method | Endpoint | Input | Output |
|---|---|---|---|
| GET | /health | None | Service status JSON |
| POST | /v1/pdf | JSON with HTML | application/pdf |
| POST | /v1/images | Raw PNG, JPEG or WebP | image/webp, image/jpeg or image/png |
| POST | /v1/image-to-pdf | Raw PNG, JPEG or WebP | application/pdf |
Check service health
curl https://docify.site/api/healthConversion endpoints accept POST, not GET or HEAD. A 405 Method Not Allowed response to curl -I on a conversion endpoint does not mean the service is offline.
Authentication and browser access
The public conversion endpoints currently need no signup or API key. Call them from server-side scripts or use the tools on docify.site. Browser applications on unrelated domains are restricted by the current CORS policy.
Input limits
- HTML to PDF accepts an HTML string up to 200,000 characters within a 1 MB JSON body. Use inline CSS and embedded data-image URLs. Remote assets and scripts are blocked.
- Image optimization and image-to-PDF inputs may be up to 20 MB. Send raw bytes with the matching image Content-Type, not multipart form data.
- Animated images are not supported. Image-to-PDF returns one page per request.
Handle errors and temporary limits
The public service allows up to 30 requests per minute per IP and limits concurrent processing. Check status codes before writing a response to disk: errors contain JSON with an error field rather than the requested file.
400: invalid JSON or options413: request is too large415/422: unsupported or invalid input429: rate limit reached. FollowRetry-After503: processing capacity is busy. Retry with a bounded delay500: processing failed. Inspect the input before retrying
To generate codebase documentation locally, see the Docify CLI guides. The CLI does not require these hosted PDF and image endpoints.