cicora.ai
مواصفات APIالمرفقات

الملفات والمرفقات

ارفع ملفًا عبر عملية مخصصة، واحتفظ بمعرّفه، ومرر مرجعًا إليه في طلب متوافق لاحق.

مرجع التكامل: اختر المعلمات والإمكانات المتاحة من إعدادات API لحسابك ومن كتالوج النماذج لبيئتك.

رفع المصدر

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

أرسل المحتوى الثنائي عبر multipart حيث يطلب المسار ذلك. لا ترمّز ملفًا كبيرًا داخل JSON عندما تتوقع العملية multipart.

رفع ملف لطلب لاحق
bash
curl --request POST https://cicora.ai/api/v1/files \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --form 'file=@analysis.pdf'

الإرفاق بطلب

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

الحذف والتدقيق

احذف المرفقات المؤقتة وفق جدول الاحتفاظ وطلبات المالك.

احتفظ بمعرّف الملف وبياناته الوصفية في سجل بدلًا من نسخ محتواه عندما لا يكون المحتوى مطلوبًا للدعم.