VocalStack Logo

Documentation

نقل و نقل کا اعداد و شمار حاصل کریں

انتظار یا مکمل نقل سے ڈیٹا حاصل کریں

مائیکرو فون یا لائیو اسٹریم سے نقل کريں

مائیکرو فون یا لائیو اسٹریم سے سلائیڈ اسپیکر سے نقل کر سکتے ہیں

نقل و نقل

سیشنز کے ساتھ نقل و نقل کی حالت کو دیکھتے اور انتظام کرتے ہیں

ترجمہ کريں

نقل کردہ متن کا ترجمہ ديگر زبان ميں کريں یہ کسی بھی نقل کے لئے کیا جاسکتا ہے، بشمول پہلے سے ریکارڈ شدہ نقل، زندہ نقل یا Polyglot سیشن نقل

URL سے آڈیو نقل کریں

URL ميں پرائيوڈ آ ڊيو سے سچے متن ميں حديث کو نقل کريں MP3, WAV, FLAC, اور OGG سمیت اہم فائلیں فارمیٹ کی حمایت کی جاتی ہے

نقلِ مطالبہ اور جواب

تمام نقل عمل کے لئے عام درخواست آپشنز اور جوابات

چند زبانوں والا سيشن نقل کريں اور پيش کريں

ایک سیشن بناؤ جو عام اشتراکی رابطے کے ذریعے ایک زندہ نقل کو برائڈکاسٹ کرنے کے لیے استعمال کیا جاسکتا ہے

کلائنٹ طرف توثیق ٹوکنز

دستاویزات براؤز کریں
کلائنٹ جانب درخواستوں کے لیے ایک عارضی توثیق ٹوکن بناؤ۔ محفوظ طور پر ویب براؤزرز میں API درخواستوں کو آپ کی API کیجوں کو ظاہر کرنے کے بغیر عمل میں لائے۔.
توثیق ٹوکن کلائنٹ ماحول میں ایک ضروری سیکورٹی قدم ہیں جہاں آپ VocalStack API سروسز کی ضرورت ہے. آپ کو یہ ضرورت ہوگی جب آپ ویب براؤزرز، ایپلیکیشنز یا کسی بھی دوسرے عوامی ماحول میں API درخواستوں کو عمل میں لاتے ہیں.
سرور کی جانب ہم ایک تصدیق ٹوکن پیدا کرنے کے لئے SDK کا استعمال کر سکتے ہیں. ڈیفالٹ سے، ٹوکن کے اختیارات محدود ہیں. آپ ان کو اپڈیٹ کرنا چاہیں گے تاکہ آپ کی ضرورتوں کو پورا کر سکیں:
  • access:یا تو "onlyread" یا "readwrite" سابق آپ کو آپ کے ڈیٹا واپس API کالوں کو چلنے کی اجازت دیتا ہے. بعد میں آپ کو بھی API درخواستوں کو اجرا کرنے کی اجازت دیتا ہے جس میں بلبل نقل متعلقہ آپریشن شامل ہیں. اس آپشن کا دیفا لٹ ویلیو : "محض پڑھنے کے لیے".
  • lifetime_s: 1 اور 120 کے درمیان ایک نمبر جو سیکنڈ میں ٹوکن کی زندگی کی نمائندگی کرتا ہے. اس عرصے کے بعد، ٹوکن ختم ہو جائے گا اور اب استعمال نہیں کیا جا سکتا۔ یاد رکھو کہ یہ اس ٹوکن کے استعمال سے پہلے شروع کی گئی غیر ہم آہنگ درخواستوں کو متاثر نہیں کرے گا. (دوسری بات میں، ایک بار ایک asynchronous درخواست شروع ہو چکی ہے، یہ مکمل ہونے تک چلے گا اگرچہ توکن درخواست کے شروع ہونے کے بعد ختم ہو گیا ہے. ) اس آپشن کے لئے دیفالٹ ما ئل ہے دس.
  • one_time: ایک بولی نشاندہی کرتا ہے کہ آیا یہ API ٹوکن ایک استعمال کے لیے ہے. اگر صحیح ہو تو، ایک بار یہ ٹوکن ایک API درخواست کے لیے استعمال کیا گیا ہے، یہ ختم ہو جائے گا. اس آپشن کا دیفا لٹ ویلیو : سچ.
یہ آپ کے سرور پر کیسا نظر آئے گا:
JavaScript
import { Security } from '@vocalstack/js-sdk'; const sdk = new Security({ apiKey: 'YOUR-API-KEY' }); const authToken = await sdk.generateToken({ access: 'readwrite', // Optional: 'readonly' or 'readwrite' lifetime_s: 60, // Optional: 1-120 seconds one_time: true, // Optional: true or false }); // Next, return the token to the client where API request will be made. // Make sure to keep the token secure and do not expose it to the public.
آپ کو آپ کے کلاینٹ کو آپ کے سرور پیدا API ٹوکن سروس کے لئے ایک طریقہ کار کی ترتیب دینے کی ضرورت ہوگی. یہ آپ کے بنیادی ڈھانچے اور ٹیکنالوجی کے ڈھیر پر بہت زیادہ منحصر ہوگا۔ آپ کو محفوظ بہترین عمل کو عمل میں لانے کے لئے یقین. مثال کے طور پر، آپ کو ایک API انتہا پوائنٹ نہیں بنانا چاہیے جو غیر تصدیق شدہ درخواستوں کے لئے پیدا کردہ API ٹوکنز کی خدمت کرتا ہے۔.
کلائنٹ طرف VocalStack API استعمال کرنے کے لئے آپ کو ایک استعمال کرنے کی ضرورت ہے authToken بدلے میں ایک apiKey.مثال کے طور پر، اس کے لئے دستاویزات پر غور کریں URL سے آڈیو نقل کریں.
اس مثال میں صرف بدلیں:
{ apiKey: 'YOUR-API-KEY' } کے ساتھ { authToken: 'YOUR-AUTH-TOKEN' } ٦
JavaScript
import { UrlTranscription } from '@vocalstack/js-sdk'; const authToken = await fetch('http://example.com/your-secured-api/authenticate') .then((response) => response.json()) .then((data) => data.token); const sdk = new UrlTranscription({ authToken }); const transcription = await sdk.connect({ url: 'http://example.com/speech.mp3' }); transcription.start();
کلائنٹ-سایڈ توثیق ٹوکنز پیدا کرنے اور سروس کرنے کے وقت، آپ کے API کو غیر مجاز رسائی سے روکنے کے لئے سخت سیکورٹی اقدامات کو عمل میں لانا ضروری ہے۔ ٹوکن وسائل اور خدمات تک رسائی کے لئے طاقتور آلات ہیں، اور اگر ان کی حفاظت نہ کی جائے تو ان کا غلط استعمال کیا جاسکتا ہے۔ آپ کو یہ یقینی بنانا ہوگا کہ صرف اختیاری کلائنٹس ہی ٹکنوں کی درخواست اور استعمال کر سکتے ہیں، اور آپ کو کبھی بھی عوامی ماحول میں API کیجوں جیسے حساس ڈیٹا کو ظاہر نہیں کرنا چاہیے۔ اس طرح کرنے میں ناکامی کے نتیجے میں ڈیٹا بریکنگ، وسائل کی غیر قانونی رسائی، یا بیلبل سروسز کے لئے غیر ارادی چارج ہو سکتا ہے۔.
آپ کے نفاذ کو محفوظ کرنے میں مدد کے لئے، ذیلی بہترین عملوں پر غور کریں:
  • آپ کی API کیجوں کو کلائنٹ کی طرف کبھی بھی نہ کھولیں: API کیز ہمیشہ رازدار رہنا چاہیے اور سرور پر محفوظ طور پر محفوظ کیا جانا چاہیے۔ کلائنٹ-سایڈ کوڈ میں ان کو ظاہر کرنا (e. جن جاواسکریپت، HTML) API کے لئے غیر مجاز رسائی کی طرف لے جا سکتا ہے.
  • محفوظ سرور جانبی ٹوکن پیداوار استعمال کریں: ہمیشہ سرور کی جانب توثیق ٹوکنز پیدا کریں کلائنٹ کوڈ میں API کی کلیدوں کے ظہور سے روکنے کیلئے۔.
  • توکنز کے لئے توثیق درخواستیں: یقین دلاؤ کہ صرف تصدیق شدہ صارف یا سروسز تصدیق کی میکانیزم کو مجبور کرکے ایک API ٹوکن کی درخواست کر سکتے ہیں (e. جناب , OAuth, سیشن اعتبار).
  • HTTPS کو عمل میں لانا: ہمیشہ HTTPS پر ٹوکنز کی خدمت کریں تاکہ آدمی-in-the-middle حملوں سے بچا سکیں.
  • URLs میں ٹوکنوں کو ظاہر کرنے سے بچیں: URL کویری پیرامیٹرز میں ٹوکنز کو کبھی بھی نہیں گزارتے کیونکہ وہ سرور لاگ میں لاگ کیے جا سکتے ہیں یا براؤزر تاریخ میں ظاہر ہو سکتے ہیں.
  • ٹکِن کا دائرہ محدود کریں: ٹوکنز کو کم سے کم ضروری اجازت ناموں تک محدود کریں، جیسے صرف پڑھنے کی رسائی مگر لکھنے کی رسائی واضح طور پر ضروری ہے.
  • ٹکنٹ ختم ہونے کا وقت مقرر کریں: ٹوکن کے غلط استعمال کے خطرے کو کم کرنے کے لئے مختصر ٹوکن کی زندگی استعمال کریں. استعمال کے نمونوں اور سیکورٹی کی ضرورتوں پر مبنی ٹوکن زندگی کے وقت کو محدود کرنے پر غور کریں.
  • ایک بار استعمال ٹوکنز فعال کریں: اگر ممکن ہو تو، خاص طور پر حساس عملوں کے لئے ایک بار استعمال ہونے والے ٹوکنوں کا استعمال کریں تاکہ یہ یقینی بنائے کہ وہ دوبارہ استعمال نہیں کی جاسکتے۔.
Scroll Up