وثائق تحويل ConvertCraft API

التسجيل

بعض الواجهات الأمامية عامة ولا تتطلب تسجيلًا. للحصول على حدود أعلى للمعدل أو الميزات المتقدمة، اشترك عبر RapidAPI للحصول على مفتاح API.

البدء (RapidAPI)

Subscribe on RapidAPI and use RapidAPI's built-in code snippets. The examples below are copy/paste templates — replace YOUR_API_KEY and YOUR_PROXY_SECRET with the values shown in RapidAPI.

1) Health check (GET /status)

curl -s \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-rapidapi-proxy-secret: YOUR_PROXY_SECRET" \
  https://api.convert-craft.com/status

2) Simple JSON tool (POST /slugify)

curl -s -X POST \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-rapidapi-proxy-secret: YOUR_PROXY_SECRET" \
  -d '{"text":"Hello World!"}' \
  https://api.convert-craft.com/slugify

3) File tool example (POST /image-convert)

File endpoints download from the sourceUrl field. Use a direct URL that returns HTTP 200 (this API intentionally does not follow redirects).

curl -s -X POST \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-rapidapi-proxy-secret: YOUR_PROXY_SECRET" \
  -d '{"sourceUrl":"https://example.com/photo.png","outputFormat":"webp"}' \
  https://api.convert-craft.com/image-convert \
  --output photo.webp

فئات الواجهات

The API provides endpoints grouped by conversion type:

• معالجة الصور — Convert, resize, and optimize images (JPG, PNG, WebP, AVIF, HEIC, SVG, GIF, TIFF, BMP, ICO)
• أدوات PDF — Convert, merge, split, compress, and rasterize PDFs
• أدوات الصوت — Convert between MP3, WAV, OGG, AAC, FLAC, M4A formats
• أدوات الفيديو — Convert MP4, WebM, MKV, MOV, AVI, extract audio from video
• أدوات النصوص — Slugify, hash, encode/decode, and other text operations
• أدوات الكريبتو — Hashing, encoding, and cryptographic utilities
• نظام — Health check, status, and API metadata

For the full list of endpoints with request/response schemas, see the OpenAPI spec.

حدود السرعة

• Free tier: 10 requests per minute
• Pro tier: 100 requests per minute
• Enterprise: Custom limits available on request

يمكن للمشتركين عبر RapidAPI الحصول على حدود سرعة أعلى.

Error Handling

All errors return JSON with a consistent structure:

{
  "error": "short_code",
  "message": "Human-readable description"
}

Common HTTP status codes:

• 400 — Bad request (missing or invalid parameters)
• 401 — Unauthorized (missing or invalid API key)
• 403 — Forbidden (invalid proxy secret or insufficient permissions)
• 429 — Rate limit exceeded
• 500 — Internal server error

Support

For API questions, bug reports, or feature requests, email [email protected] or join our Discord community.