دليل المنتج وAPI

قوالب السوق

ما تقدمه التصاميم الجاهزة

يوفر السوق تصاميم بداية أعدها PDFgine للمقترحات والتقارير والعروض التقديمية والمستندات المشابهة. بعد إضافة قالب إلى مساحة عملك يمكنك تعديل نصوصه وبياناته وألوانه وتخطيطه في أداة الإنشاء.

حاليًا ينشر PDFgine وحده القوالب في السوق. لا يوجد مسار يتيح للعملاء بيع قوالبهم الخاصة.

أنواع الوصول

  • مجاني: يمكن لمستخدم يملك الإذن المطلوب إضافة القالب مباشرةً إلى مساحة العمل.
  • مشمول بالخطة: لا توجد رسوم إضافية عندما تشمل خطة اشتراكك النشطة القالب.
  • مدفوع: يمكن تثبيت القالب في مساحة العمل المعنية بعد التحقق من الدفعة الواحدة.

الحصول على قالب واستخدامه

  1. اعثر على تصميم بالفئة أو البحث ثم افحص غلافه ووصفه.
  2. أضف قالبًا مجانيًا أو مشمولًا بالخطة، أو أكمل الدفع الآمن لتصميم مدفوع.
  3. يضيف التثبيت نسخة قابلة للتحرير من التصميم إلى قسم القوالب في مساحة العمل المحددة.
  4. افتحه في أداة الإنشاء واستبدل البيانات النموذجية ببياناتك وتحقق من مخرجات PDF وWord والعارض قبل النشر.

يجب أن يكون رمز القالب فريدًا داخل مساحة العمل. لا يستبدل التعارض القالب الموجود؛ بل يُطلب منك اختيار رمز آخر.

النشر والتثبيت عبر API

كل ما تفعله شاشة السوق متاح عبر طرف نهائي: سرد المنشور ونسخ قالب إلى حسابك ونشر قالب لك وتحديد سعره.

cURL 
# اسرد العناصر المنشورة
curl -s "https://api.pdfgine.com/api/v1/marketplace/templates?locale=en" \
  -H "X-PDFgine-Key: $PDFGINE_KEY"

# انسخ قالبًا إلى حسابك
curl -X POST https://api.pdfgine.com/api/v1/marketplace/templates/consulting-proposal/install \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "code": "proposal", "name": "عرض مقترح" }'

# انشر أحد قوالبك
curl -X POST https://api.pdfgine.com/api/v1/templates/invoice/marketplace \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "title": "فاتورة بشروط دفع",
        "summary": "قالب فوترة يتضمن شروط الدفع وكتلة المجاميع.",
        "category": "reports",
        "locale": "en",
        "license": "commercial",
        "visibility": "public",
        "confirmAssetRedistributionRights": true
      }'

# حدد السعر - يلزم priceMinorUnits عندما تكون isFree بالقيمة false
curl -X PUT https://api.pdfgine.com/api/v1/marketplace/templates/invoice-with-payment-terms/offer \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "isFree": false,
        "priceMinorUnits": 4900,
        "currency": "USD",
        "includedPlanCodes": ["business", "enterprise"],
        "expectedVersion": 3
      }'

ينسخ التثبيت القالب إلى حسابك، ولا تصل تغييرات الناشر اللاحقة إلى نسختك. يطلب منك النشر تأكيد امتلاك حق إعادة توزيع الخطوط والصور التي يتضمنها القالب، ويُسجل هذا التأكيد.

مخططاتك وقوالبك

لا يتطلب إنشاء قالبك أو مخططك شراءً من السوق. ما يُباع هو التصميم الجاهز الذي أعده PDFgine.

فتح السوق →

الأخطاء الشائعة

  • ينسخ التثبيت التصميم إلى مساحة عملك. لا تصل أعمال الناشر اللاحقة إلى النسخة، ولا تُستبدل تعديلاتك أيضًا.
  • يجب أن يكون الرمز غير مستخدم في مساحة عملك. لا يستبدل التعارض قالبك أبدًا؛ يُرفض التثبيت ويُطلب رمز آخر.
  • حاليًا ينشر PDFgine فقط. تجيب أطراف النشر والعروض بالحالة 403 لمساحة عمل دون دور الناشر، لذا لا تبنِ عليها مسار بيع بعد.
  • يحمل مؤشر السرد عوامل التصفية. يؤدي تغيير البحث أو الفئة أو اللغة مع إبقاء before إلى 400 عمدًا، وإلا لأشار المؤشر نفسه إلى قائمة مختلفة.
  • لا يُثبت التصميم المدفوع إلا بعد التحقق من دفعه. استدعاء install أولًا ثم checkout يؤدي إلى رفض لا إلى قائمة انتظار.