رسائی ٹوکنز کس کے لیے ہیں
رسائی ٹوکنز آپ کے اپنے اسکرپٹس اور تیسرے فریق کے انضمام کو آپ کے اسٹور کی جانب سے Storeep API سے بات کرنے دیتے ہیں۔ ہر ٹوکن اجازتوں کا ایک مقررہ سیٹ، ایک اختیاری ڈیٹا ونڈو، اور ایک اختیاری اختتامی تاریخ رکھتا ہے۔ ٹوکنز آپ کے ڈیش بورڈ لاگ ان کا اشتراک کرنے سے زیادہ محفوظ ہیں کیونکہ آپ ہر ایک کو بالکل اسی چیز تک محدود کرتے ہیں جس کی کسی انضمام کو ضرورت ہے اور اسے کسی بھی وقت اکیلے منسوخ کر دیتے ہیں۔
ٹوکنز سنبھالنے کے لیے، ترتیبات، رسائی ٹوکنز پر جائیں۔ دستاویزات دیکھیں بٹن ایک نئے ٹیب میں مکمل API حوالہ کھولتا ہے۔
ٹوکن کی حدود
- آپ فی اسٹور 40 رسائی ٹوکنز تک رکھ سکتے ہیں۔ جب آپ 40 تک پہنچ جاتے ہیں، تو نیا ٹوکن بنائیں بٹن غائب ہو جاتا ہے جب تک کہ آپ ایک حذف نہ کریں۔
- ٹوکنز نیا پہلے درج ہوتے ہیں، فی صفحہ 20۔
ٹوکن بنانا
نیا ٹوکن بنائیں پر کلک کریں، فارم بھریں، پھر بنائیں پر کلک کریں۔
ٹوکن کا نام
- لازمی، 50 حروف تک۔
- صرف آپ کی فہرست میں ٹوکن کی شناخت کے لیے استعمال ہوتا ہے۔ یہ کبھی تیسرے فریق کو نہیں بھیجا جاتا۔
اجازتیں
چار دائروں میں سے کم از کم ایک منتخب کریں۔ ہر ایک آزاد ہے، اور API ہر اس درخواست کو مسترد کر دیتا ہے جس کا دائرہ آپ نے نہیں دیا (ایک 403 "ناکافی اجازتیں" جواب جو مطلوبہ دائرے کا نام دیتا ہے):
- ریڈ پروڈکٹس: مصنوعات کی فہرست، تفصیلات، اقسام، اور انوینٹری ڈیٹا تک رسائی۔
- ریڈ آرڈرز: آرڈر کی تاریخ، تفصیلات، حالتیں، اور لائن آئٹمز تک رسائی۔
- ریڈ ویب ہکس: اپنی ویب ہک ترتیبات کی فہرست اور انہیں دیکھیں۔
- منیج ویب ہکس: ویب ہکس بنائیں، اپ ڈیٹ کریں، اور حذف کریں۔
اگر آپ کچھ منتخب نہیں کرتے، تو تخلیق "براہ کرم کم از کم ایک اجازت منتخب کریں" کے ساتھ ناکام ہو جاتی ہے۔ ویب ہکس خود ترتیبات، ویب ہکس کے تحت ترتیب دیے جاتے ہیں؛ یہ دائرے صرف ان تک API رسائی کنٹرول کرتے ہیں۔
ڈیٹا رسائی
یہ کنٹرول کرتا ہے کہ ٹوکن وقت میں کتنا پیچھے تک آپ کا ڈیٹا پڑھ سکتا ہے۔ سب سے زیادہ محدود اختیار منتخب کریں جو پھر بھی کام کرے۔
- گزشتہ 24 گھنٹے (ڈیفالٹ): ٹوکن صرف ایک رولنگ 24 گھنٹے کی ونڈو کا ڈیٹا دیکھتا ہے، جو ہر درخواست پر دوبارہ حساب کیا جاتا ہے۔ سب سے محفوظ، حقیقی وقت کے فیڈز کے لیے مثالی۔
- آغاز کی تاریخ مقرر کریں: ٹوکن صرف آپ کی منتخب کردہ کیلنڈر تاریخ یا اس کے بعد بنایا گیا ڈیٹا دیکھتا ہے۔ اسے منتخب کرنا ایک ڈیٹا رسائی آغاز کی تاریخ منتخب کنندہ ظاہر کرتا ہے۔
- تمام وقت: کوئی تاریخی پابندی نہیں، ٹوکن تمام تاریخ پڑھتا ہے۔ صرف اس وقت استعمال کریں جب کسی انضمام کو واقعی اس کی ضرورت ہو۔
اختتام
- کبھی ختم نہیں ہوتا (ڈیفالٹ): جب تک آپ اسے حذف نہ کریں درست رہتا ہے۔
- اختتامی تاریخ مقرر کریں: ایک اختتامی تاریخ منتخب کنندہ ظاہر کرتا ہے۔ تاریخ کم از کم ایک دن آگے اور آج سے ایک سال سے زیادہ نہیں ہونی چاہیے۔ اس کے گزرنے کے بعد، ٹوکن خودکار طور پر کام کرنا بند کر دیتا ہے اور کوئی بھی API کال "رسائی ٹوکن ختم ہو گیا ہے" واپس کرتی ہے۔
ٹوکن کی قدر (ایک بار دکھائی جاتی ہے)
بنائیں پر کلک کرنے کے بعد، ٹوکن کی قدر (ایک UUID) کامیابی کے پیغام میں ایک بار نمودار ہوتی ہے۔ اسے فوراً کہیں محفوظ جگہ کاپی اور محفوظ کریں۔ Storeep اسے دوبارہ کبھی نہیں دکھاتا اور اسے بحال نہیں کر سکتا۔ اگر آپ اسے کھو دیتے ہیں، تو ٹوکن حذف کریں اور ایک نیا بنائیں۔
API کے ساتھ ٹوکن استعمال کرنا
- قدر کو ایک HTTP ہیڈر میں Authorization: Bearer YOUR_TOKEN کے طور پر بھیجیں۔ ایک غائب یا غلط شکل والا ہیڈر ایک 401 خرابی واپس کرتا ہے۔
- ہر ٹوکن 60 درخواست فی 60 سیکنڈ تک محدود ہے۔ اس سے زیادہ ہونا ایک 429 "ریٹ کی حد سے تجاوز" جواب واپس کرتا ہے، چنانچہ پیچھے ہٹیں اور ونڈو کے دوبارہ سیٹ ہونے کے بعد دوبارہ کوشش کریں۔
- فہرست اینڈ پوائنٹس ایک market فلٹر (ایک ملک کا کوڈ یا 20 تک) قبول کرتے ہیں، نیز limit (1 سے 50، ڈیفالٹ 20)، page (ڈیفالٹ 1)، اور created_at یا updated_at کے لحاظ سے ترتیب۔ اینڈ پوائنٹ URLs اور مکمل تفصیلات کے لیے دستاویزات دیکھیں دیکھیں۔
ٹوکن میں ترمیم
کسی بھی ٹوکن کی قطار پر کلک کر کے اس کا نام، اجازتیں، ڈیٹا رسائی موڈ، اور اختتام میں ترمیم کریں۔ آپ ٹوکن کی قدر خود نہیں دیکھ یا بدل سکتے، ترمیم صرف موجودہ ٹوکن سے منسلک ترتیبات اپ ڈیٹ کرتی ہے، چنانچہ انضمام بغیر کسی نئی قدر کے کام کرتے رہتے ہیں۔
ٹوکنز کی فہرست کے کالم
- نام: وہ لیبل جو آپ نے اسے دیا، نیچے تخلیق کی تاریخ اور وقت کے ساتھ۔
- اجازتیں: دیے گئے دائرے (یا کوئی نہیں)۔
- ڈیٹا رسائی: گزشتہ 24 گھنٹے، تمام ڈیٹا، یا [تاریخ] سے دکھاتا ہے۔
- اختتام: اختتامی تاریخ، یا کبھی نہیں۔
- آخری بار استعمال: ٹوکن کی آخری تصدیق شدہ API کال کی تاریخ اور وقت، یا کبھی نہیں۔
ٹوکن حذف کرنا
ایک یا زیادہ ٹوکنز منتخب کریں اور ٹوکنز حذف کریں پر کلک کریں، یا فی قطار حذف ایکشن استعمال کریں۔ حذف کرنا فوری اور حتمی ہے: وہ قدر اب بھی استعمال کرنے والا کوئی بھی انضمام فوراً 401 تصدیقی خرابیاں پانے لگتا ہے۔
سیکیورٹی تجاویز
- صرف وہی دائرے دیں جن کی کسی انضمام کو واقعی ضرورت ہو۔
- براہ راست فیڈز کے لیے گزشتہ 24 گھنٹے ڈیٹا رسائی رکھیں، اور شیڈول شدہ ہم وقت سازیوں کے لیے آغاز کی تاریخ مقرر کریں استعمال کریں۔
- قلیل مدتی ٹھیکیداروں یا یک بار کے کاموں کے لیے ایک اختتامی تاریخ مقرر کریں۔
- آخری بار استعمال کالم دیکھیں: ایک ٹوکن جو کبھی نہیں استعمال ہوا یا طویل عرصے سے غیر فعال ہے، غالباً کسی مردہ انضمام سے تعلق رکھتا ہے اور اسے حذف کرنا محفوظ ہے۔