VocalStack Logo

Documentation

Kupata data ya kutafsiri

Kupata data kutoka kusitishwa au kukamilika transcriptions

Kuandika kutoka kwa Mikrofoni au LiveStream

Kuandika hotuba ya moja kwa moja kutoka kwa mikrofoni au mtiririko wa moja kwa moja

Mafunzo ya kutafsiri

Kufuatilia na kudhibiti hali ya transcription na mikutano

Kutafsiri Transcription

Kutafsiri maandishi transcribed kwa lugha nyingine

Kuhamisha Audio kutoka URL

Kuandika hotuba kutoka sauti iliyorekodiwa katika URL hadi maandishi ya kawaida

Mteja upande Uthibitishaji Tokens

Maombi ya kutafsiri na Majibu

Common maombi chaguzi na majibu kwa ajili ya shughuli zote transcription

Kuandika na Kuwasilisha Sehemu ya Polyglot

Kuunda mkutano ambao unaweza kutumika kwa ajili ya kutangaza kuishi transcription kupitia umma shareable kiungo

Mteja upande Uthibitishaji Tokens

Tazama nyaraka
Kujenga muda authentication token kwa maombi upande wa mteja. Salama kutekeleza maombi API katika browsers wavuti bila kuonyesha vifungo API yako.
Uthibitishaji tokens ni hatua muhimu ya usalama katika mazingira ya mteja ambapo unahitaji huduma VocalStack API. Utakuwa kuhitaji hii wakati kutekeleza maombi API katika browsers wavuti, programu au mazingira mengine yoyote ya umma.

Kuzalisha Authentication Token

Katika upande wa server tunaweza kutumia SDK kwa kuzalisha auth token. Kwa kawaida, chaguzi kwa ajili ya token ni vikwazo. Unaweza kutaka kuboresha haya ili kukidhi mahitaji yako:
  • access: Ama "soma tu" au "soma-andika". Mtangulizi inaruhusu wewe kutekeleza API wito kwamba kurudi data. Baadaye inaruhusu wewe pia kutekeleza maombi API kwamba ni pamoja na billable transcription kuhusiana na shughuli. thamani default kwa ajili ya chaguo hili ni "soma tu".
  • lifetime_s: idadi kati ya 1 na 120 kuwakilisha maisha ya ishara katika sekunde. Baada ya muda huu, alama itaisha na haitatumika tena. Kumbuka kwamba hii haitaathiri maombi asynchronous ambayo tayari imeanza kutumia token hii. (Kwa maneno mengine, mara moja ombi asynchronous imeanza, itaendesha kwa kukamilika hata kama token imepita baada ya ombi imeanza. ) thamani default kwa ajili ya chaguo hili ni. 10 ya.
  • one_time: Boolean kuashiria kama hii API token ni maana kwa ajili ya matumizi moja. Kama kweli, mara moja hii token imekuwa kutumika kwa ajili ya ombi API, itaisha. thamani default kwa ajili ya chaguo hili ni kweli.
Hapa ni nini hii itakuwa kuangalia kama kwenye seva yako:
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.
Utakuwa na haja ya kuanzisha utaratibu wa kuhudumia server yako yanayotokana API token kwa mteja wako. Hii itategemea sana juu ya miundombinu yako na tech stack. Hakikisha wewe kutekeleza mazoezi bora ya usalama. Kwa mfano, unapaswa si kujenga API mwisho pointi ambayo hutoa yaliyotokana API tokens kwa maombi unauthenticated.

Kutumia Uthibitishaji Token

Kutumia VocalStack API juu ya upande wa mteja inahitaji wewe kutumia. authToken kuweka badala ya apiKey. Kwa mfano, fikiria nyaraka kwa ajili ya [kiungo aina ya "nyaraka" id="d23c4ea1-0d15-4af6-b124-805ef2f12066"].
Katika mfano huu tu badala:
{ apiKey: 'YOUR-API-KEY' } na { authToken: 'YOUR-AUTH-TOKEN' } 26.10.2009. ]
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();

Usalama Maoni

Wakati kuzalisha na kuhudumia tokens client-upande uthibitishaji, ni muhimu kutekeleza hatua kali za usalama ili kuzuia upatikanaji bila idhini ya API yako. Tokeni ni zana yenye nguvu ya kupata rasilimali na huduma, na kama hawatahifadhiwa, wanaweza kutumiwa vibaya. Unapaswa kuhakikisha kwamba wateja tu mamlaka ya kuuliza na kutumia tokens, na unapaswa kamwe kuonyesha data nyeti kama vile API funguo katika mazingira ya umma. Kushindwa kufanya hivyo kunaweza kusababisha ukiukaji wa data, ufikiaji usioruhusiwa wa rasilimali, au malipo yasiyokusudiwa kwa huduma zinazolipwa.
Ili kusaidia kulinda utekelezaji wako, angalia mazoea bora yafuatayo:
  • Kamwe Expose yako API Vifunguo juu ya upande wa mteja: API funguo lazima daima kubaki siri na kuhifadhiwa kwa usalama kwenye seva. Kuonyesha yao katika code client-side (e. m JavaScript, HTML) inaweza kusababisha upatikanaji bila idhini ya API.
  • Matumizi salama Server-Sehemu Token Vizazi: Daima kuzalisha uthibitisho tokens kwenye upande wa server ili kuzuia maambukizi ya API funguo katika mteja code.
  • Kuthibitisha Maombi kwa Tokens: Kuhakikisha kwamba watumiaji tu authenticated au huduma inaweza kuomba API token kwa kutekeleza taratibu uthibitishaji (e. (G) , OAuth, kikao uthibitishaji).
  • kutekeleza HTTPS: Daima kutumikia tokens juu HTTPS kulinda dhidi ya man-in-the-middle mashambulizi.
  • Kuepuka Exposing Tokens katika URLs: Kamwe kupita tokens katika URL maswali vigezo kama wao inaweza kuwa alijiandikisha katika logi server au kuonyesha katika historia ya kivinjari.
  • Kukataza Token wigo: Kikomo tokens kwa idhini ya chini ya muhimu, kama vile kusoma-pekee upatikanaji isipokuwa kuandika upatikanaji ni wazi inahitajika.
  • Kuanzisha Token Kuisha: Matumizi ya muda mfupi wa maisha ya token ili kupunguza hatari ya matumizi mabaya ya token. Kuzingatia kudhibiti token lifetimes kulingana na mifumo ya matumizi na mahitaji ya usalama.
  • Kuwezesha moja-Wakati Matumizi Tokens: Ikiwa inawezekana, tumia alama za mara moja kwa vitendo maalumu vya hisia ili kuhakikisha kuwa haziwezi kutumika tena.
Scroll Up