API Reference

RESTv1.0

Integrate UniService tools into your applications via our REST API.

Getting Started

All API requests use the following base URL:

https://uniservice.unidev.uz/api/api/v1

Authentication

Include your API key in the X-API-Key header:

curl
curl -X POST https://uniservice.unidev.uz/api/api/v1/qr/generate \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"content": "https://example.com"}'

Get your API key from Dashboard → API Keys.

QR Code Generator

POST/v1/qr/generate

Generate a QR code with customizable options.

ParameterTypeRequiredDescription
contentstringRequiredURL or text to encode
formatstringOptionalpng, svg, or jpg (default: png)
sizeintegerOptionalImage size in pixels (default: 300)
fg_colorstringOptionalForeground color hex (default: #000000)
bg_colorstringOptionalBackground color hex (default: #FFFFFF)

Code Sharing

POST/v1/code/create

Create a code snippet.

ParameterTypeRequiredDescription
contentstringRequiredCode content (max 100KB)
titlestringOptionalSnippet title
languagestringOptionalProgramming language (default: plaintext)
visibilitystringOptionalpublic or private (default: public)
expires_instringOptional1h, 1d, 1w, 1m, or never

URL Shortener

POST/v1/shortener/create

Shorten a URL with optional alias and password.

ParameterTypeRequiredDescription
urlstringRequiredURL to shorten (max 2048 chars)
custom_aliasstringOptionalCustom short code
passwordstringOptionalPassword to protect the link
expires_atdatetimeOptionalExpiration date (ISO 8601)

File Converter

POST/v1/converter/convert

Convert a file to another format. Returns a job ID for polling.

ParameterTypeRequiredDescription
filefileRequiredFile to convert (multipart upload)
target_formatstringRequiredTarget format (png, jpg, pdf, docx, etc.)

Rate Limits

PlanAPI Calls / MonthMax File SizeStorage
Free1,00010 MB30 days
Pro ($29/mo)50,000100 MBUnlimited
EnterpriseUnlimitedUnlimitedUnlimited

Status Codes

200Success
201Created successfully
400Bad request — invalid parameters
401Unauthorized — missing or invalid API key
403Forbidden — insufficient permissions
404Not found
410Gone — resource has expired
422Validation error
429Rate limit exceeded
500Internal server error