شارٹ لنکس کا بلک امپورٹ اور ایکسپورٹ

جب آپ کے پاس مختصر کرنے کے لیے درجنوں یا ہزاروں URL ہوں، تو ہر لنک ہاتھ سے بنانے کے بجائے انہیں ایک CSV فائل میں اپ لوڈ کریں۔ ہر قطار ایک عام شارٹ لنک بن جاتی ہے جسے آپ کسی بھی دوسرے لنک کی طرح ترمیم، شیئر اور ٹریک کر سکتے ہیں۔

Note

بلک تخلیق آپ کے پلان پر منحصر ہے۔ ہر بنی ہوئی قطار کی لاگت اسے ہاتھ سے بنانے جتنی ہے، اور امپورٹ یا ایکسپورٹ پر کوئی اضافی لاگت نہیں۔ تفصیلات کے لیے کریڈٹس کا صفحہ دیکھیں۔ فیچر کریڈٹس

CSV فائل سے شارٹ لنکس امپورٹ کریں

1. ڈیش بورڈ میں URL شارٹنر کھولیں اور بلک امپورٹ منتخب کریں۔

2. CSV ٹیمپلیٹ ڈاؤن لوڈ کریں، ہر لنک کے لیے ایک قطار بھریں اور اسے CSV کے طور پر محفوظ کریں۔

3. فائل اپ لوڈ کریں اور وہ ڈیفالٹس منتخب کریں جو خالی کالم والی قطاروں پر لاگو ہوں، جیسے ٹیمپلیٹ یا ٹیگ۔

4. فائل چیک کریں۔ Posty5 کچھ بنائے بغیر ہر قطار پڑھتا ہے اور ان قطاروں کی فہرست دکھاتا ہے جو ناکام ہوں گی۔

5. امپورٹ شروع کریں۔ آپ صفحہ چھوڑ سکتے ہیں، اور مکمل ہونے پر ایک اطلاع آپ کو بتائے گی۔

فائل کے کالم

صرف url کالم لازمی ہے۔ کالم کے نام کیس حساس نہیں ہیں، اور جو کالم Posty5 نہیں پہچانتا اسے نظرانداز کیا جاتا ہے اور چیک کے مرحلے میں بتایا جاتا ہے۔

Column
url	منزل کا پتہ۔ لازمی۔ baseUrl کو بھی اس کے دوسرے نام کے طور پر قبول کیا جاتا ہے۔
name	آپ کی اپنی فہرست کے لیے ایک نام۔ خالی چھوڑنے پر Posty5 پس منظر میں صفحے کے عنوان سے اسے بھر دیتا ہے۔
customId	شارٹ لنک کا آپ کا اپنا اختتام، جب آپ کا پلان کسٹم ID کی اجازت دیتا ہو۔ یہ غیر استعمال شدہ ہونا چاہیے، اسی فائل کی کسی پچھلی قطار میں بھی نہیں۔
tag	بعد میں لنکس کو گروپ اور فلٹر کرنے کے لیے ایک ٹیگ۔
refId	آپ کا اپنا حوالہ، مثلاً آپ کے سسٹم کا کوئی پروڈکٹ کوڈ۔
templateId	اس قطار کا QR کوڈ ٹیمپلیٹ۔ یہ آپ کے منتخب کردہ ڈیفالٹ کی جگہ لیتا ہے۔

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

فائل کو کوما اور ہیڈر قطار کے ساتھ UTF-8 CSV کے طور پر محفوظ کریں۔ جن اقدار میں کوما ہو وہ ڈبل کوٹس میں جاتی ہیں، جیسا کہ اسپریڈشیٹ ایپس خود کرتی ہیں۔

فائل کی جانچ

جانچ وہی اصول چلاتی ہے جو ہاتھ سے لنک بنانے پر لاگو ہوتے ہیں اور ہر ناکام قطار کو اس کے قطار نمبر کے ساتھ دکھاتی ہے، جو ہیڈر کے نیچے پہلی قطار سے گنا جاتا ہے۔ قطار تب ناکام ہوتی ہے جب

• URL موجود نہیں، درست ویب پتہ نہیں، یا 2,048 حروف سے لمبا ہے
• URL غیر محفوظ ہونے کی وجہ سے بلاک ہے
• نام، ٹیگ یا حوالہ 255 حروف سے لمبا ہے
• کسٹم ID آپ کے پلان میں اجازت یافتہ نہیں، غلط ہے، یا پہلے سے استعمال میں ہے
• ٹیمپلیٹ موجود نہیں یا آپ کا نہیں ہے

حدود

• ایک فائل میں زیادہ سے زیادہ 5,000 قطاریں اور 2 MB ہو سکتے ہیں۔
• آپ روزانہ (UTC) بلک میں زیادہ سے زیادہ 20,000 قطاریں بنا سکتے ہیں، جس میں ہر امپورٹ اور API کال ایک ساتھ گنی جاتی ہیں۔
• ایک وقت میں ایک امپورٹ چلتا ہے، اور زیادہ سے زیادہ تین مزید اس کا انتظار کر سکتے ہیں۔
• اگر امپورٹ کے دوران آپ کے کریڈٹس ختم ہو جائیں، تو وہ قطار اور اس کے بعد کی ہر قطار “کریڈٹس کافی نہیں ہیں” کی خرابی کے ساتھ ناکام ہوتی ہے، اور پہلے سے بنے لنکس باقی رہتے ہیں۔

پیش رفت

امپورٹ کا صفحہ دکھاتا ہے کہ کتنی قطاریں پروسیس ہوئیں، بنیں اور ناکام ہوئیں، اور خود بخود ریفریش ہوتا ہے۔ آپ چلتا ہوا امپورٹ منسوخ کر سکتے ہیں؛ منسوخی سے پہلے بنے لنکس باقی رہتے ہیں۔

ہر لنک بننے کے بعد صفحے کے عنوانات اور ایپ ڈیپ لنکس پس منظر میں حاصل کیے جاتے ہیں، اس لیے تھوڑی دیر تک کوئی لنک اپنے ہوسٹ کو نام کے طور پر دکھا سکتا ہے۔

نتائج کی فائل

امپورٹ مکمل ہونے پر اس کی نتائج کی فائل ڈاؤن لوڈ کریں۔ اس میں آپ کی فائل کی ہر قطار کے لیے ایک لائن ہوتی ہے۔

Column
row	آپ کی فائل میں قطار نمبر، ہیڈر کے نیچے پہلی قطار سے گنا ہوا۔
status	created، failed، skipped، یا notProcessed جب امپورٹ اس قطار تک پہنچنے سے پہلے رک گیا۔
id, shortUrl	نئے لنک کی ID اور مختصر پتہ۔
errors	قطار کیوں ناکام ہوئی۔

ایک دوسری فائل میں صرف ناکام قطاریں آپ کی اصل اقدار کے ساتھ ہوتی ہیں، تاکہ آپ انہیں درست کر کے وہ فائل دوبارہ اپ لوڈ کر سکیں۔

پچھلے امپورٹس

بلک جابز آپ کے حالیہ امپورٹس کو ان کی حالت اور تعداد کے ساتھ دکھاتا ہے۔ پیش رفت دیکھنے یا فائلیں دوبارہ ڈاؤن لوڈ کرنے کے لیے کوئی ایک کھولیں۔

Caution

اپ لوڈ کی گئی فائلیں اور نتائج کی فائلیں 7 دن اور امپورٹ کا ریکارڈ 30 دن رکھا جاتا ہے۔ اس سے پہلے جو ضرورت ہو ڈاؤن لوڈ کر لیں۔ لنکس خود کبھی نہیں ہٹائے جاتے۔

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 میں شروع میں ایک اپوسٹروفی ملتی ہے، تاکہ اسپریڈشیٹ ایپ اسے فارمولے کے طور پر چلانے کے بجائے متن کے طور پر دکھائے۔