Convertica API

لماذا Convertica API

بداية سريعة

1. إصدار مفتاح في لوحة التحكم الخاصة بك

انتقل إلى لوحة تحكم مفاتيح API الخاصة بك وأنشئ مفتاحًا مسمى. يظهر المفتاح الكامل مرة واحدة — انسخه فورًا.

2. تقديم طلب

مثال curl — تحويل PDF إلى Word:

curl -X POST https://convertica.net/api/v1/pdf-to-word/ \
  -H "Authorization: Bearer cvk_live_xxxxxxxxxxxxxxxx" \
  -F "[email protected]" \
  -o output.docx

مثال بايثون

import requests
r = requests.post(
    "https://convertica.net/api/v1/pdf-to-word/",
    headers={"Authorization": "Bearer cvk_live_xxxxxxxxxxxxxxxx"},
    files={"pdf_file": open("input.pdf", "rb")},
)
with open("output.docx", "wb") as f:
    f.write(r.content)

مثال Node.js

import fs from "node:fs";
import { request } from "undici";
const form = new FormData();
form.set("pdf_file", new Blob([fs.readFileSync("input.pdf")]), "input.pdf");
const r = await request("https://convertica.net/api/v1/pdf-to-word/", {
  method: "POST",
  headers: { Authorization: "Bearer cvk_live_xxxxxxxxxxxxxxxx" },
  body: form,
});
fs.writeFileSync("output.docx", Buffer.from(await r.body.arrayBuffer()));

المصادقة

أرسل مفتاح الواجهة البرمجية الخاص بك كرمز Bearer في رأس Authorization. المفاتيح مرتبطة باشتراكك — يمكنك إلغاؤها وتدويرها في أي وقت من لوحة التحكم.

• حتى 10 مفاتيح نشطة لكل حساب، مع نطاق مسمى اختياري
• البادئة معروضة في لوحة التحكم لسهولة التعريف (المفتاح الكامل يظهر فقط عند الإنشاء)
• الحصة الشهرية لكل مفتاح مرتبطة بمستوى الاشتراك — العداد يُعاد تعيينه في اليوم الأول
• مُجزّأ عند التخزين؛ إذا تسرب مفتاح، قم بإلغائه وإصدار مفتاح جديد في ثوانٍ

إشعارات الويب غير المتزامنة

المهام الكبيرة تُرجع معرف مهمة وتعمل في الخلفية. إما استطلاع نقطة نهاية المهمة، أو تعيين رابط رد اتصال ودع Convertica يدفع النتيجة.

curl -X POST https://convertica.net/api/v1/pdf-to-word/ \
  -H "Authorization: Bearer cvk_live_xxxxxxxxxxxxxxxx" \
  -F "[email protected]" \
  -F "callback_url=https://yourapp.example/convertica-hook"

حمولات إشعارات الويب موقعة بـ HMAC-SHA256 باستخدام السر المعروض في لوحة التحكم. تحقق من رأس X-Convertica-Signature قبل الوثوق بالمحتوى.

الحدود وتحديد المعدل

ما ستحصل عليه

• أكثر من 30 نقطة نهاية للتحويل: PDF↔Word، Excel، PPT، JPG، PNG، HTML، EPUB، Markdown
• تحرير PDF: دمج، تقسيم، تدوير، علامة مائية، توقيع، ضغط، قص، تسطيح
• الصور: تحسين، تحويل، HEIC→JPG/PNG
• أوضاع متزامنة (ملفات صغيرة) وغير متزامنة (ملفات كبيرة)
• استدعاءات خطاف ويب موقعة بـ HMAC اختيارية للنتائج غير المتزامنة
• توثيق OpenAPI 3
• متوسط أقل من 200 مللي ثانية، حافة الاتحاد الأوروبي
• نفس الخلفية المستخدمة في convertica.net — مجربة في المعارك

الأسئلة المتكررة