استيراد الروابط المختصرة وتصديرها بالجملة

عندما يكون لديك عشرات أو آلاف الروابط لاختصارها، ارفعها في ملف CSV واحد بدلًا من إنشاء كل رابط يدويًا. يصبح كل صف رابطًا مختصرًا عاديًا يمكنك تعديله ومشاركته وتتبعه مثل أي رابط آخر.

استيراد الروابط المختصرة من ملف CSV

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

أعمدة الملف

عمود url هو الوحيد المطلوب. أسماء الأعمدة لا تتأثر بحالة الأحرف، وأي عمود لا يعرفه Posty5 يُتجاهل ويظهر في خطوة الفحص.

Column
`url`	العنوان الذي يوجّه إليه الرابط. مطلوب. ويُقبل baseUrl اسمًا بديلًا له.
`name`	اسم يظهر في قائمتك. إذا تُرك فارغًا يملؤه Posty5 من عنوان الصفحة في الخلفية.
`customId`	نهاية الرابط المختصر التي تختارها، إذا كانت خطتك تسمح بالمعرّفات المخصصة. يجب ألا تكون مستخدمة، ولا في صف سابق من الملف نفسه.
`tag`	وسم لتجميع الروابط وتصفيتها لاحقًا.
`refId`	مرجعك الخاص، مثل رمز منتج من نظامك.
`templateId`	قالب رمز QR لهذا الصف، ويتقدّم على القيمة الافتراضية التي اخترتها.

url,name,customId,tag,refId,templateId
https://example.com/spring-sale,Spring sale,,spring,,

احفظ الملف بصيغة CSV بترميز UTF-8 مع فواصل وصف عناوين. القيم التي تحتوي على فواصل توضع بين علامتي تنصيص، كما تفعل برامج الجداول تلقائيًا.

فحص الملف

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

يكون الرابط مفقودًا أو غير صالح أو أطول من 2,048 حرفًا
يكون الرابط محظورًا لأنه غير آمن
يكون الاسم أو الوسم أو المرجع أطول من 255 حرفًا
يكون المعرّف المخصص غير مسموح في خطتك أو غير صالح أو مستخدمًا بالفعل
يكون القالب غير موجود أو لا يخصك

الحدود

يتسع الملف الواحد حتى 5,000 صف و2 ميغابايت.
يمكنك إنشاء حتى 20,000 صف بالجملة في اليوم (بتوقيت UTC)، بحساب كل عمليات الاستيراد واستدعاءات API معًا.
يعمل استيراد واحد في كل مرة، ويمكن أن ينتظر بعده حتى ثلاثة أخرى.
إذا نفد رصيدك أثناء الاستيراد، يفشل ذلك الصف وكل صف بعده برسالة الرصيد غير كافٍ، وتبقى الروابط التي أُنشئت بالفعل.

التقدم

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

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

ملف النتائج

عند انتهاء الاستيراد، نزّل ملف نتائجه. يحتوي على سطر لكل صف من ملفك.

Column
`row`	رقم الصف في ملفك، بدءًا من أول صف تحت العناوين.
`status`	created أو failed أو skipped، أو notProcessed إذا توقف الاستيراد قبل الوصول إلى الصف.
`id`, `shortUrl`	معرّف الرابط الجديد وعنوانه المختصر.
`errors`	سبب فشل الصف.

ويحتوي ملف ثانٍ على الصفوف الفاشلة فقط بقيمها الأصلية، لتصحّحها وترفع ذلك الملف مرة أخرى.

عمليات الاستيراد السابقة

تعرض صفحة المهام بالجملة عمليات الاستيراد الأخيرة بحالتها وأعدادها. افتح أيًا منها لترى تقدمه أو لتنزّل ملفاته مجددًا.

الإنشاء بالجملة عبر API

يمكن للمطورين إرسال حتى 100 صف في طلب واحد والحصول على نتيجة لكل صف فورًا، أو إرسال ملف حتى 5,000 صف كمهمة ومتابعتها. تنطبق الحدود والفحوص نفسها، ويحترم الطلب ترويسة Idempotency-Key حتى لا يُنشئ الطلب المعاد الروابط مرتين. المسارات موثقة في مرجع API (Swagger).

POST /api/short-link/bulk
POST /api/link-bulk-jobs
GET /api/short-link/export

تصدير روابطك

من قائمة الروابط المختصرة، اختر تصدير CSV أو تصدير JSON لتنزيل روابطك مع عدّادات زياراتها.

يستخدم التصدير عوامل التصفية المطبقة على القائمة، فصفِّ أولًا لتصدير جزء منها فقط.
يتسع التصدير الواحد حتى 50,000 صف، الأحدث أولًا. وتُقطع القائمة الأطول عند هذا الحد، ويذكر الملف ذلك في سطره الأخير (CSV) أو في حقل truncated (JSON).
الخلية التي تبدأ بـ = أو + أو - أو @ تُسبق بفاصلة عليا في ملف CSV، حتى يعرضها برنامج الجداول نصًا بدلًا من تنفيذها كصيغة.