Getting Started
API Services

API Documentation

Welcome to the 7awel developer documentation. Our API provides a robust, sandbox-isolated processing engine for all your file conversions, document extractions, image manipulations, and text utilities. Integrating our single gateway eliminates the need to run local heavy dependencies like wkhtmltopimage, LibreOffice, Python AI models, or GD libraries.

Base URL: http://www.7awel.com/api/v1

Authentication

Authenticate your API requests by including your personal API token in the HTTP Authorization header as a Bearer token: 

Authorization: Bearer YOUR_API_TOKEN

You can retrieve or regenerate your token at any time inside your developer Settings page.

Response Formats

By default, successful requests yield a file download. However, you can pass the boolean parameter include_file = true in your request body to receive a structured JSON response containing the base64-encoded output.

Success JSON Response:
{
  "status": "success",
  "mime_type": "image/png",
  "file_content": "iVBORw0KGgoAAAANSUhEUgAA..."
}
Error JSON Response:
{
  "status": "error",
  "messages": [
    "The requested file size exceeds your current tier limit."
  ]
}

HTML to PDF & Image Converter API

Convert raw HTML markup or complete pages into images or documents.

POST /convert/html/{to}

Allowed target formats ({to}): pdf, png, jpg, bmp, svg.

Request Parameters:
Parameter Type Default Description
input Body (String) Required The raw HTML markup content to convert.
info.width Body (Integer) 625 Width of the output viewport for image renders.
info.percentage_quality Body (Integer) 80 Compression quality of rendering images (1-100).
info.font_size_em Body (Integer) 1 Font size in em units for the rendered HTML tables.
info.font_family Body (String) Arial Font family used (Arial, Tahoma, Verdana, Courier New, Times New Roman).
info.align Body (String) left Text alignment of the table columns (left, center, right).
info.css Body (String) null Custom CSS rules to apply styling overrides on the table.
info.top / info.bottom / info.left / info.right Body (Integer) 20 Padding in pixels for the table (top, bottom, left, right margins).

Image Processing & Background Removal API

Process, compress, crop, resize, or remove backgrounds using our isolated image processors.

POST /convert/{from}/{to}

Allowed sources ({from}): webp, jpg, png.

Actions & Target Formats ({to}):
Target / Action Parameter Type / Default Description
bg_removed info.bg_removed.res_ext String (matches source) AI-powered background removal. Output extension can be set to png, webp, or jpg.
compressed info.percentage_quality Integer (80) Lossy compression factor (1-100).
resized info.percentage_quality Integer (50) Scale percentage (1-100%) to resize the image width and height.
cropped info.top / info.bottom / info.left / info.right Integer (0) Crop offset margins in pixels from the respective edges (top, bottom, left, right).

PDF Conversion & Metadata Stripping API

Split, merge, extract data, or render PDF pages into images.

POST /convert/pdf/{to}
Conversion Targets ({to}):
Target Required Body Info Parameters Description
webp, jpg, png file (PDF File) info.percentage_quality (Default: 50) Render pages as compressed images. Maps 1-100 quality directly to 72-300 DPI resolution.
csv file (PDF File) None Extract tabular data structure to CSV format.
txt file (PDF File) None Extract raw plain text from the document.
info_stripped file (PDF File) None Strip creator, tags, and all metadata properties from the PDF.
images_extracted file (PDF File) None Extract all embedded raster images from the document pages.
pages_splitted file (PDF File) None Split the PDF into individual standalone single-page PDF files.
merged files[] (PDF Files Array) None Merge multiple uploaded PDF files into a single output PDF document.

Spreadsheet Conversion & Sanitization API

Convert between Excel, CSV, and JSON structures while sanitizing document metadata.

POST /convert/{from}/{to}

Allowed sources ({from}): xlsx, xls, csv, json.

Allowed targets ({to}): xlsx, xls, csv, json, info_stripped.

Note: Multiple worksheets within a spreadsheet are structured dynamically as separate worksheets inside the output JSON object, or generated as a compressed archive for CSV conversions.

Text, Captcha, Barcode & QR Code API

Generate Captcha security tokens, barcodes, and dynamic QR Code vectors directly from text inputs.

POST /convert/txt/{to}
Request Parameters:
Target Parameter Type / Default Description
captcha input String (3-6 chars) Renders a secure PNG Captcha code from the text input.
qr info.qr.ext String (PNG) Target file format (PNG, SVG, HTML).
info.width Integer (300) Output pixel block dimension.
barcode info.barcode.ext String (PNG) Target file format (PNG, SVG, HTML, JPG).
info.width Integer (30) Output vertical height of the barcode.
info.barcode.showCode Boolean (false) If set to true, prints raw text value underneath the code.
info.barcode.format String (C128) Standard format (e.g. C128, UPCA, EAN13).