ForHosting KIT · المستندات وملفات PDF

تعيين بيانات PDF الوصفية

عنوان مكتوب بمسافات زائدة يعود بصيغة Quarterly Report، وتندمج الكلمتان المفتاحيتان Finance وfinance في كلمة واحدة بالكتابة الأولى. نظّم خصائص ملف PDF قبل دخوله إلى أرشيف أو نظام نشر، دون أي تغيير في الملف نفسه. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

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

جهّزوا ملف PDF صالحاً وكائن بيانات وصفية

تتحقق الإمكانية من التمثيل، لكنها لا تنزّل عنوان URL بعيداً ولا تعيد كتابة وحدات بايت المستند. ضعوا خصائص المستند المقترحة داخل كائن البيانات الوصفية. العنوان إلزامي لأن العنوان الفارغ يحول دون تعريف الملف في نتائج البحث والأرشيفات وعلامات تبويب المتصفح وأنظمة إدارة المستندات.

أما المؤلف والموضوع والكلمات المفتاحية فهي اختيارية. يجب أن تكون كل خاصية قياسية سلسلة نصية؛ ويمكن أن تكون الكلمات المفتاحية مصفوفة من السلاسل أو سلسلة مفصولة بفواصل أو فواصل منقوطة. يجعل هذا الشكل الصريح تشخيص الأخطاء يسيراً قبل وصول القيم إلى مرحلة كتابة PDF.

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

افهموا بدقة كيفية عمل التطبيع

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

إذا أصبح حقل المؤلف أو الموضوع الاختياري فارغاً بعد التشذيب، يُحذف من الناتج بدلاً من إرجاعه بقيمة null أو كعنصر نائب فارغ. وتخضع الكلمات المفتاحية للمعالجة نفسها. تُستبعد المدخلات الفارغة، وتُقارن التكرارات من دون اعتبار لاختلاف حالة الأحرف الإنجليزية؛ ولذلك تنتج “Annual Report” و“annual report” كلمة مفتاحية واحدة، مع الاحتفاظ بصياغة أول ظهور.

ويتبع ترتيب الكلمات أيضاً أول ظهور مفيد، مما يجعل النتائج متوقعة للاختبارات وذاكرات التخزين المؤقت اللاحقة. يخضع العنوان لقواعد المسافات نفسها، لكنه لا يجوز أن يختفي: تؤدي القيمة المفقودة أو غير النصية أو المؤلفة من مسافات فقط إلى خطأ إدخال غير صالح.

استخدموا النتيجة المطَبّعة في مسار مستندات آمن

تعيد الاستجابة تمثيل PDF المتحقق منه إلى جانب كائن بيانات وصفية يحتوي على العنوان المطَبّع الإلزامي، ولا يضم من الحقول الاختيارية إلا ما يحمل محتوى مفيداً. هذه خطوة إعداد وتحقق وليست محرراً ثنائياً لملفات PDF. تستطيع أداة كتابة لاحقة أخذ الاستجابة وتعيين حقول معلومات PDF أو XMP المقابلة، ثم تطبيق قواعدها الخاصة بالتوقيعات والتشفير والاحتفاظ وتسلسل وحدات البايت.

يفيد هذا الفصل عندما تأتي البيانات الوصفية من نماذج أو جداول بيانات أو أنظمة محتوى أو عمليات تصدير آلية: ارفضوا السجلات المشوهة مبكراً، وراجعوا القيم النظيفة بصورة مستقلة، ولا تستدعوا معالجة المستندات المكلفة إلا للسجلات الناجحة. كما يفيد في عمليات النقل الجماعي، حيث تؤدي المسافات غير المتسقة والكلمات المفتاحية المتكررة إلى جوانب بحث مشوشة عبر آلاف المستندات. ولأن هذه الإمكانية لا تجري طلبات شبكية ولا تخزن حالة، يمكنها العمل باتساق في مسارات المتصفح والخادم مع إنتاج العقد المطَبّع نفسه لكليهما.

حالات الاستخدام

التحقق من نماذج النشر

تحققوا من العناوين التي يقدمها المحررون وطبّعوا الحقول الوصفية الاختيارية قبل كتابة ملف PDF النهائي.

تنظيف عمليات نقل الأرشيف

أزيلوا اختلافات المسافات والكلمات المفتاحية المكررة عند إعداد سجلات المستندات القديمة لأرشيف جديد.

حماية إنشاء PDF الآلي

أوقفوا التقارير التي لا تحمل عنواناً قبل بدء مرحلة مكلفة للتصيير أو كتابة بيانات PDF الوصفية.

الأسئلة الشائعة

هل تعدّل هذه الإمكانية وحدات بايت PDF؟

لا. إنها تتحقق من تمثيل PDF وتعيد بيانات وصفية مطَبّعة إلى أداة كتابة PDF لاحقة.

ما حقول البيانات الوصفية المدعومة؟

العنوان والمؤلف والموضوع والكلمات المفتاحية. العنوان إلزامي، أما الحقول الأخرى فهي اختيارية.

هل يمكن تقديم الكلمات المفتاحية في سلسلة واحدة؟

نعم. تُقسّم السلسلة عند الفواصل أو الفواصل المنقوطة. ويمكنكم أيضاً تقديم مصفوفة من السلاسل.

كيف تُعالج الكلمات المفتاحية المكررة؟

تُحذف التكرارات من دون اعتبار لحالة الأحرف بعد تطبيع المسافات، مع حفظ أول صياغة والترتيب.

ماذا يحدث إذا كان العنوان فارغًا؟

يُرفض السجل. العنوان إلزامي لأن العنوان الفارغ لا يفيد في تمييز الملف في نتائج البحث أو الأرشيف أو علامات تبويب المتصفح، والعنوان المكوّن من مسافات فقط يُعد فارغًا أيضًا.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/pdf/set-metadata

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/pdf/set-metadata \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pdf":"https://ejemplo.com/documento.pdf","metadata":{"title":"Quarterly Report","author":"Ada Lovelace","subject":"Operations","keywords":["finance","quarterly report"]}}'

const res = await fetch("https://api.kit.forhosting.com/pdf/set-metadata", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pdf": "https://ejemplo.com/documento.pdf",
    "metadata": {
      "title": "Quarterly Report",
      "author": "Ada Lovelace",
      "subject": "Operations",
      "keywords": [
        "finance",
        "quarterly report"
      ]
    }
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/set-metadata",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pdf": "https://ejemplo.com/documento.pdf",
    "metadata": {
        "title": "Quarterly Report",
        "author": "Ada Lovelace",
        "subject": "Operations",
        "keywords": [
            "finance",
            "quarterly report"
        ]
    }
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/set-metadata", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"pdf":"https://ejemplo.com/documento.pdf","metadata":{"title":"Quarterly Report","author":"Ada Lovelace","subject":"Operations","keywords":["finance","quarterly report"]}}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf","metadata":{"title":"Quarterly Report","author":"Ada Lovelace","subject":"Operations","keywords":["finance","quarterly report"]}}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/set-metadata", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "pdf": "https://ejemplo.com/documento.pdf",
  "metadata": {
    "title": "Quarterly Report",
    "author": "Ada Lovelace",
    "subject": "Operations",
    "keywords": [
      "finance",
      "quarterly report"
    ]
  }
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.set_metadata",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`max_mb`	25
`max_pages`	200

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

جهّزوا ملف PDF صالحاً وكائن بيانات وصفية

أرسلوا ملف PDF بإحدى الصيغ المدعومة: URI لبيانات PDF مرمزة بصيغة base64، أو سلسلة أولية تبدأ بتوقيع PDF، أو URL من نوع HTTPS يدل مساره على ملف PDF، أو مرجع رفع خاص بالعدة.

افهموا بدقة كيفية عمل التطبيع

ولا تدخل ساعة أو قيمة عشوائية أو خدمة خارجية أو حالة خاصة بالبيئة في هذه القرارات، لذلك ينتج مُدخل JSON المتطابق دائماً مُخرج JSON متطابقاً.

استخدموا النتيجة المطَبّعة في مسار مستندات آمن

تبلغ كلفة كل استدعاء $0.002 لكل عنصر، ولذلك ترتفع الكلفة بصورة متوقعة مع عدد السجلات المتحقق منها.

أسئلة تقنية

ماذا يحدث عندما لا يحتوي العنوان إلا على مسافات؟

يفشل الطلب بخطأ invalid_input لأن التطبيع سيترك عنواناً فارغاً.

ما كلفة الطلب الواحد؟

تبلغ كلفة كل عنصر متحقق منه $0.002، من دون رسوم إضافية للشبكة أو النموذج.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

جهّزوا ملف PDF صالحاً وكائن بيانات وصفية

افهموا بدقة كيفية عمل التطبيع

استخدموا النتيجة المطَبّعة في مسار مستندات آمن

حالات الاستخدام

التحقق من نماذج النشر

تنظيف عمليات نقل الأرشيف

حماية إنشاء PDF الآلي

الأسئلة الشائعة

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الحدود

الأخطاء

ملاحظات تقنية

جهّزوا ملف PDF صالحاً وكائن بيانات وصفية

افهموا بدقة كيفية عمل التطبيع

استخدموا النتيجة المطَبّعة في مسار مستندات آمن

أسئلة تقنية

شكرًا