واجهة المطورين

توثيق API

نقاط API موثقة للتعامل مع مهام التحويل، الصيغ، حالة الووركر، الدفع، ومفاتيح API.

The API is built for agencies, print shops and partner tools that need automated compatibility jobs.
المصادقة

استخدم مفتاح VersionFixer API في Authorization: Bearer أو X-VersionFixer-Key.

إنشاء مهمة

POST /wp-json/versionfixer/v1/jobs مع الملف، الهدف، الخيارات، والخدمة عند الحاجة.

قائمة المهام

GET /wp-json/versionfixer/v1/jobs تعرض أحدث المهام للحساب الموثق.

الصيغ

GET /wp-json/versionfixer/v1/formats تعرض الصيغ، الإصدارات، العمليات، والخدمات.

الووركر

GET /wp-json/versionfixer/v1/workers تلخص جاهزية محركات التحويل.

Authentication

Use Authorization: Bearer vf_live_xxx or X-VersionFixer-Key. API keys are hashed in user meta and can be rotated from the account/API endpoint.

Job creation

POST multipart/form-data to /wp-json/versionfixer/v1/jobs with file, format, target, options and optional service.

Job history

GET /wp-json/versionfixer/v1/jobs returns recent authenticated account jobs with status, credits, worker note and download URL when ready.

Operational model

Workers can be separated by format family so Adobe, CAD, 3D and PDF queues do not block each other.

Response model

Successful job responses include job ID, status, detected format, target version, credit cost and the next polling/download URL when available.

Error model

Errors are returned as readable JSON messages with HTTP status codes such as 400 for invalid files, 402 for credits, 429 for rate limits and 500 for worker failures.

Launch FAQ

Can a partner rotate API keys?

Yes. Authenticated users can rotate their key through the API key endpoint.

Does the API expose supported formats?

Yes. /wp-json/versionfixer/v1/formats returns formats, versions, operations, services and engine status.

Can API jobs be billed?

Yes. Jobs use the same plan and credit logic as the web converter.

Can developers check worker availability before upload?

Yes. Use /wp-json/versionfixer/v1/workers or /engines to decide whether to show instant conversion, queue, retry, or support-escalation messaging.

curl -H "Authorization: Bearer vf_live_xxx" \
  -F "file=@design.ai" \
  -F "target=Illustrator CS6" \
  https://versionfixer.com/wp-json/versionfixer/v1/jobs
curl https://versionfixer.com/wp-json/versionfixer/v1/formats
curl https://versionfixer.com/wp-json/versionfixer/v1/engines
curl https://versionfixer.com/wp-json/versionfixer/v1/workers
{
  "success": false,
  "data": {
    "message": "File is required."
  }
}