إدارة ملف CSV

يوفر دليل واجهة برمجة التطبيقات هذا نظرة عامة حول كيفية استخدام ملف csv لإنشاء طلب مجمع.

---

لبدء طلب مجمع، ستحتاج إلى توفير ملف csv يحتوي على جميع أسماء متغيرات القالب كرؤوس أعمدة csv:

الاسم الأول	اسم العائلة	شركة
Johan	Smith	Immersivefox
Jack	Parker	Red Chillies

سيتم استخدام هذه الحقول كوحدات ماكرو في المعالجة المجمعة لتخصيص المحتوى الناتج وتخصيصه🌟

بدء سريع

دعنا نتعمق ونستكشف كيفية تحميل ملفات csv وإدراجها، حتى تتمكن من إنشاء مقاطع فيديو مجمعة بكفاءة باستخدامها لاحقًا.

تحميل ملف CSV:

لتحميل ملف CSV جديد، استخدم نقطة نهاية واجهة برمجة التطبيقات هذه. ما عليك سوى إدخال ملف CSV في بيانات الطلب وإرسال البيانات كـ multipart/form-data. في المقابل، ستتلقى 'id' والذي يمكنك استخدامه كـ 'csv_id' لإنشاء طلبات مجمعة (video_request.md) وقوالب (templates) (template.md). للاطلاع، إليك نموذج لملف CSV (https://storage.googleapis.com/immersive-fox-backend-bucket/bulk_csv_file/test2_EzNtkVJ.csv).

طلبالرد

curl --request POST  \
     --url 'https://api.immersive-fox.com/v1/bulk_requests/upload_csv/'  \
     --header 'X-Api-Key: <your-api-key>'  \
     --header 'Content-Type: multipart/form-data' \
      -F 'csv_file=@my_contacts.csv'

{
    "id": 172,
    "user": 31,
    "file_name": "my_contacts.csv",
}

قائمة ملفات CSV:

لاسترداد ملفات CSV التي تم تحميلها سابقًا، استخدم نقطة نهاية واجهة برمجة التطبيقات هذه. ستتضمن الاستجابة قائمة بجميع ملفات CSV، ويمكنك استخدام 'id' لملف CSV المطلوب كـ 'csv_id' لإنشاء طلبات مجمعة وقوالب.

طلبالرد

curl --request GET  \
     --url 'https://api.immersive-fox.com/v1/bulk_requests/csvs/'  \
     --header 'X-Api-Key: <your-api-key>'  \
     --header 'Content-Type: application/json'

[
    {
        "id": 120,
        "user": 31,
        "file_name": "my_contacts.csv",
    },
    {
        "id": 159,
        "user": 31,
        "file_name": "my_employees.csv",
    }
]