ایکسیس ٹوکن کس لیے ہیں
ایکسیس ٹوکن بیرونی ایپلیکیشنز (آپ کی اپنی اسکرپٹس، انٹیگریشنز، analytics ٹولز، یا webhook processors) کو Storeep API کے ذریعے آپ کے اسٹور کا ڈیٹا پڑھنے دیتے ہیں۔ ہر ٹوکن کا محدود اجازت کا مجموعہ اور اختیاری میعاد ختم ہونے کی تاریخ ہوتی ہے۔ ٹوکن اکاؤنٹ کی اسناد شیئر کرنے سے زیادہ محفوظ ہیں کیونکہ انہیں صرف وہی دائرہ کار دیا جا سکتا ہے جو انٹیگریشن کو چاہیے اور کسی بھی وقت انفرادی طور پر منسوخ کیا جا سکتا ہے۔
ٹوکن منظم کرنے کے لیے Settings → Access tokens پر جائیں۔ پینل میں ایک View documentation بٹن API ریفرنس سے لنک کرتا ہے۔
ٹوکن کی حدیں
- فی اسٹور زیادہ سے زیادہ 40 ایکسیس ٹوکن۔ یہ حد پہنچنے پر Create new token بٹن چھپ جاتا ہے۔
- ٹوکن پہلے نئے کی ترتیب میں درج ہوتے ہیں، 20 فی صفحہ۔
ٹوکن بنانا
Create new token پر کلک کریں، فارم بھریں، اور Create پر کلک کریں۔
ٹوکن کا نام
- لازمی۔
- زیادہ سے زیادہ 50 حروف۔
- صرف ٹوکن فہرست میں شناخت کے لیے استعمال ہوتا ہے۔ تھرڈ پارٹیز کو کبھی نہیں بھیجا جاتا۔
اجازتیں
چار دستیاب اجازت دائروں میں سے کم از کم ایک منتخب کریں۔ ہر دائرہ آزاد ہے:
- Read products: پروڈکٹ لسٹنگز، تفصیلات، ویریئنٹس اور انوینٹری ڈیٹا تک رسائی۔
- Read orders: آرڈر کی تاریخ، تفصیلات، حالتیں اور لائن اشیاء تک رسائی۔
- Read webhooks: webhook ترتیبات اور ترسیل کے logs دیکھیں۔
- Manage webhooks: webhook subscriptions بنائیں، اپ ڈیٹ کریں اور حذف کریں۔
آپ کو کم از کم ایک دائرہ منتخب کرنا ضروری ہے۔ منتخب نہ کیا گیا دائرہ اس ٹوکن کے لیے ناقابل رسائی ہوتا ہے چاہے API endpoint موجود ہو۔
ڈیٹا رسائی
یہ ترتیب طے کرتی ہے کہ ٹوکن آپ کے ڈیٹا تک وقت میں کتنا پیچھے رسائی حاصل کر سکتا ہے۔ سب سے محدود اختیار منتخب کریں جو آپ کی انٹیگریشن کی ضروریات پوری کرے۔
- Last 24 hours (ڈیفالٹ): ٹوکن صرف گزشتہ 24 گھنٹوں کا ڈیٹا رسائی کر سکتا ہے۔ لائیو آرڈر feeds جیسی real-time انٹیگریشنز کے لیے تجویز شدہ۔
- Set start date: ٹوکن ایک مخصوص کیلنڈر تاریخ سے آگے کا ڈیٹا رسائی کر سکتا ہے۔ منتخب ہونے پر ایک Data access start date تاریخ منتخب کنندہ ظاہر ہوتا ہے۔
- All time: کوئی تاریخ پابندی نہیں۔ ٹوکن تمام تاریخی ڈیٹا رسائی کر سکتا ہے۔ صرف اسی وقت استعمال کریں جب انٹیگریشن کو واقعی مکمل تاریخ درکار ہو۔
میعاد
- Never expires (ڈیفالٹ): ٹوکن دستی طور پر حذف ہونے تک غیر معینہ مدت تک درست ہے۔
- Set expiration date: منتخب ہونے پر ایک Expiration date تاریخ منتخب کنندہ ظاہر ہوتا ہے۔ تاریخ آج سے کم از کم ایک دن اور زیادہ سے زیادہ ایک سال مستقبل میں ہونی چاہیے۔ میعاد ختم ہونے کے بعد ٹوکن خودبخود کام کرنا بند کر دیتا ہے۔
ٹوکن کی قدر
Create پر کلک کرنے کے بعد ٹوکن کی قدر کامیابی کے پیغام میں ایک بار دکھائی جاتی ہے۔ اسے کاپی کریں اور محفوظ طریقے سے محفوظ کریں۔ Storeep اسے دوبارہ نہیں دکھا سکتا۔ اگر آپ اسے کھو دیں تو ٹوکن حذف کریں اور نیا بنائیں۔
ٹوکن ترمیم کرنا
اس کا نام، اجازتیں، ڈیٹا رسائی موڈ اور میعاد ختم ہونے کی تاریخ ترمیم کرنے کے لیے ٹوکن قطار پر کلک کریں۔ آپ ٹوکن کی قدر خود واپس نہیں لے سکتے یا تبدیل نہیں کر سکتے۔ ترمیم صرف موجودہ ٹوکن سے منسلک ترتیبات بدلتی ہے۔
ٹوکن فہرست کے کالم
- Name: آپ کا دیا گیا ٹوکن کا لیبل، اس کے نیچے بنانے کی تاریخ کے ساتھ۔
- Permissions: دیے گئے دائروں کی فہرست۔
- Data access: موڈ کے مطابق Last 24 hours، All data، یا From [date] دکھاتا ہے۔
- Expiration: میعاد ختم ہونے کی تاریخ، یا Never۔
- Last used: وہ تاریخ اور وقت جب ٹوکن آخری بار تصدیق شدہ API درخواست کرنے کے لیے استعمال ہوا، یا Never۔
ٹوکن حذف کرنا
ایک یا زیادہ ٹوکن منتخب کریں اور Delete tokens پر کلک کریں۔ حذف شدہ ٹوکن فوری طور پر غیر فعال ہو جاتے ہیں۔ حذف شدہ ٹوکن استعمال کرنے والی کوئی بھی انٹیگریشن authentication کی غلطیاں ملنا شروع ہو جائے گی۔
سیکورٹی کے اشارے
- ہر انٹیگریشن کے لیے صرف کم از کم ضروری اجازتیں دیں۔
- webhooks اور real-time feeds کے لیے Last 24 hours ڈیٹا رسائی استعمال کریں، scheduled sync jobs کے لیے Set start date استعمال کریں۔
- قلیل مدتی ٹھیکیداروں یا ایک بار کی انٹیگریشنز کو دیے جانے والے ٹوکن کے لیے میعاد ختم ہونے کی تاریخ مقرر کریں۔
- Last used کالم مانیٹر کریں۔ وہ ٹوکن جو کبھی استعمال نہ ہوا ہو یا حال ہی میں استعمال نہ ہوا ہو کسی غیر فعال انٹیگریشن کا ہو سکتا ہے اور محفوظ طریقے سے حذف کیا جا سکتا ہے۔