OpenFileConverter Edge WASM Studio
Go Pro
Screen #31 of 60 Batch 6 desktop • 1440x900px

Desktop Developer Hub `/docs/api/` — Fold 1: Quickstart, Auth & cURL Snippets

Open Route
Specification & Codex Reference Prompt (Click to expand) (Developer documentation Fold 1: Quickstart guide, Bearer token authentication, rate limit headers, and copyable cURL / Python / Node.js snippets.)

Screen Role: Developer documentation Fold 1: Quickstart guide, Bearer token authentication, rate limit headers, and copyable cURL / Python / Node.js snippets.

Design Intent: A developer documentation portal UI mockup at 1440x900 resolution in crisp Light Mode (Developer Hub Fold 1 of 3). White background (#FFFFFF) with a 3-column documentation layout: - Left Column (240px): Sidebar navigation with links ("Getting Started", "Authentication", "Endpoints", "Webhooks", "SDKs", "Errors"). - Center Column (660px): Main content titled "OpenFileConverter REST API Quickstart". Text explaining API key generation, Bearer authentication, and endpoint baseURL `https://api.openfileconverter.com/v1`. - Right Column (540px): Syntax-highlighted code block container in light slate (#F8FAFC) with a 1px border (#E2E8F0) and tab buttons [ cURL | Python | Node.js ]: `curl -X POST https://api.openfileconverter.com/v1/convert \` ` -H "Authorization: Bearer omni_live_99a8f..." \` ` -F "target_format=webp" \` ` -F "file=@photo.png"` Top button "Generate API Key". Developer-first aesthetic (similar to Stripe docs), JetBrains Mono code font, zero emojis.

Component Architecture: Django Cotton components (<c-file_converter.* />) with Tailwind tokens matching Labb.io design language.

Direct route: /file-converter/docs/api/ Template: file_converter/screens/screen_31.html
Live Django Implementation (desktop)
Isolate →
Documentation • REST API

OpenFileConverter API Reference

Guides

Base URL

https://openfileconverter.com/api/convert/

The convert endpoint accepts a multipart POST with a file field and a target_format field, and returns the conversion result with a one-hour download URL. Uploads are capped at 50 MB.

Authentication

No account or API key is needed. Send a client-issued opaque session token (8–64 characters: A-Z a-z 0-9 - _) as a bearer credential. Quota is tracked per token and per network.

Authorization: Bearer <your-session-token>

Issued team API keys are on the roadmap; the session-token contract above is the supported authentication today.

Limits & Quota

Free usage allows 5 per day conversions on standard pairs (2 per day for medium-cost pairs), counted per session and per client network. Pro raises the ceiling to 500 per day for $12/month via Stripe checkout.

Unsupported pairs return HTTP 422 with an explicit in-rollout notice — the API never reports a fabricated completed status.

MCP for AI Agents

A Model Context Protocol server exposes the same capabilities over JSON-RPC 2.0 at /api/v1/mcp/, with discovery at /.well-known/mcp.json.

cURL
curl -X POST https://openfileconverter.com/api/convert/ \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -F "target_format=webp" \
  -F "file=@photo.png"
← HTTP 200
{"status": "completed", "target_size_bytes": 184320, "duration_ms": 612, "download_url": "/download/<job-uuid>/?fmt=webp", "download_expires_in": 3600}
Unsupported pairs: HTTP 422 {"status": "in_rollout", ...}
Original Codex Reference Mockup Full PNG
Authoritative Reference for Screen #31