From bee90520bdcc3a18e9c07c8b15d76475063a0536 Mon Sep 17 00:00:00 2001 From: Trilok Yadav Date: Tue, 7 Apr 2026 22:40:11 +0530 Subject: [PATCH] Revamp EkaScribe docs: add Quick Start, reorder integrations, fix SDK titles - Add Quick Start page with TS SDK integration guide - Reorder integration methods: SDKs (recommended) > REST APIs > Chrome Extension - Move EkaScribe SDKs above APIs in sidebar, TypeScript SDK first - Fix SDK sidebar titles (proper casing for iOS, TypeScript, etc.) - Nest deprecated APIs under EkaScribe APIs with warning icons - Rename IP Allowlisting to System Requirements, add System Requirements for Extension - Remove unused ip-whitelisting-for-clients nav entry --- .../health-ai/ekascribe/SDKs/TS-sdk.mdx | 4 + .../health-ai/ekascribe/SDKs/android-sdk.mdx | 4 + .../health-ai/ekascribe/SDKs/ios-sdk.mdx | 4 + .../health-ai/ekascribe/SDKs/java-sdk.mdx | 4 + .../health-ai/ekascribe/SDKs/python-sdk.mdx | 4 + .../ekascribe/System-Requirements.mdx | 4 +- .../ekascribe-v1/retrieve-transcribe.mdx | 5 +- .../ekascribe/ekascribe-v1/upload-voice.mdx | 6 +- .../health-ai/ekascribe/overview.mdx | 38 ++++---- .../health-ai/ekascribe/quick-start.mdx | 93 +++++++++++++++++++ docs.json | 42 ++++----- 11 files changed, 166 insertions(+), 42 deletions(-) create mode 100644 api-reference/health-ai/ekascribe/quick-start.mdx diff --git a/api-reference/health-ai/ekascribe/SDKs/TS-sdk.mdx b/api-reference/health-ai/ekascribe/SDKs/TS-sdk.mdx index cfb784f5..b7e38cbf 100644 --- a/api-reference/health-ai/ekascribe/SDKs/TS-sdk.mdx +++ b/api-reference/health-ai/ekascribe/SDKs/TS-sdk.mdx @@ -1,3 +1,7 @@ +--- +title: "TypeScript SDK" +--- + # Eka Care Ekascribe Typescript SDK Integration This guide explains how to integrate the Eka Care Ekascribe Typescript SDK into your application. diff --git a/api-reference/health-ai/ekascribe/SDKs/android-sdk.mdx b/api-reference/health-ai/ekascribe/SDKs/android-sdk.mdx index dde90259..4e4e1b03 100644 --- a/api-reference/health-ai/ekascribe/SDKs/android-sdk.mdx +++ b/api-reference/health-ai/ekascribe/SDKs/android-sdk.mdx @@ -1,3 +1,7 @@ +--- +title: "Android SDK" +--- + # EkaScribe SDK Documentation EkaScribe SDK (Voice2Rx) is an Android SDK for voice-based medical transcription and documentation. diff --git a/api-reference/health-ai/ekascribe/SDKs/ios-sdk.mdx b/api-reference/health-ai/ekascribe/SDKs/ios-sdk.mdx index 5cbe3c6e..1a90df99 100644 --- a/api-reference/health-ai/ekascribe/SDKs/ios-sdk.mdx +++ b/api-reference/health-ai/ekascribe/SDKs/ios-sdk.mdx @@ -1,3 +1,7 @@ +--- +title: "iOS SDK" +--- + # EkaScribe iOS SDK A Swift package for voice-to-prescription functionality with audio recording and real-time transcription capabilities for medical consultation applications. diff --git a/api-reference/health-ai/ekascribe/SDKs/java-sdk.mdx b/api-reference/health-ai/ekascribe/SDKs/java-sdk.mdx index 700bee80..48f7ef29 100644 --- a/api-reference/health-ai/ekascribe/SDKs/java-sdk.mdx +++ b/api-reference/health-ai/ekascribe/SDKs/java-sdk.mdx @@ -1,3 +1,7 @@ +--- +title: "Java SDK" +--- + # Eka Care Ekascribe Java SDK Integration This guide explains how to integrate the Eka Care Ekascribe Java SDK. diff --git a/api-reference/health-ai/ekascribe/SDKs/python-sdk.mdx b/api-reference/health-ai/ekascribe/SDKs/python-sdk.mdx index 7b0d9d55..f4a696cf 100644 --- a/api-reference/health-ai/ekascribe/SDKs/python-sdk.mdx +++ b/api-reference/health-ai/ekascribe/SDKs/python-sdk.mdx @@ -1,3 +1,7 @@ +--- +title: "Python SDK" +--- + # Eka Care Ekascribe Python SDK Integration This guide explains how to integrate the Eka Care Ekascribe Python SDK. diff --git a/api-reference/health-ai/ekascribe/System-Requirements.mdx b/api-reference/health-ai/ekascribe/System-Requirements.mdx index 1fc3ab34..b0cd052f 100644 --- a/api-reference/health-ai/ekascribe/System-Requirements.mdx +++ b/api-reference/health-ai/ekascribe/System-Requirements.mdx @@ -1,4 +1,6 @@ - +--- +title: "System Requirements for Extension" +--- Before integrating EkaScribe, ensure your system meets the following requirements: diff --git a/api-reference/health-ai/ekascribe/ekascribe-v1/retrieve-transcribe.mdx b/api-reference/health-ai/ekascribe/ekascribe-v1/retrieve-transcribe.mdx index dcde3244..b3546c8d 100644 --- a/api-reference/health-ai/ekascribe/ekascribe-v1/retrieve-transcribe.mdx +++ b/api-reference/health-ai/ekascribe/ekascribe-v1/retrieve-transcribe.mdx @@ -1,8 +1,11 @@ --- -title: Retrieve Result +title: "Retrieve Result" openapi: GET /voice-record/api/status/{session_id} +icon: "triangle-exclamation" --- +This API is deprecated. Please use the [EkaScribe v2 APIs](/api-reference/health-ai/ekascribe/ekascribe-v2/overview) or the [SDKs](/api-reference/health-ai/ekascribe/quick-start) instead. + ### Code to decode base64 encoded FHIR response diff --git a/api-reference/health-ai/ekascribe/ekascribe-v1/upload-voice.mdx b/api-reference/health-ai/ekascribe/ekascribe-v1/upload-voice.mdx index 958ea6f5..f51defae 100644 --- a/api-reference/health-ai/ekascribe/ekascribe-v1/upload-voice.mdx +++ b/api-reference/health-ai/ekascribe/ekascribe-v1/upload-voice.mdx @@ -1,3 +1,7 @@ --- +title: "Upload Voice" openapi: "POST /voice/upload?mode={mode}&txnid={txnid}" ---- \ No newline at end of file +icon: "triangle-exclamation" +--- + +This API is deprecated. Please use the [EkaScribe v2 APIs](/api-reference/health-ai/ekascribe/ekascribe-v2/overview) or the [SDKs](/api-reference/health-ai/ekascribe/quick-start) instead. \ No newline at end of file diff --git a/api-reference/health-ai/ekascribe/overview.mdx b/api-reference/health-ai/ekascribe/overview.mdx index b14f8395..cc2b0f69 100644 --- a/api-reference/health-ai/ekascribe/overview.mdx +++ b/api-reference/health-ai/ekascribe/overview.mdx @@ -12,25 +12,11 @@ EkaScribe offers **3 different ways** to integrate voice-to-text functionality i -### 1. 🔌 **Chrome Extension** -*Ready-to-use browser extension* - -**What it is**: A browser extension that works directly in Chrome -**Who it's for**: Individual doctors, clinics, or practices wanting immediate access -**Requirements**: Chrome browser only - -**How it works**: -- Install extension → Click record → Get structured medical notes -- No coding required -- Works on any website or application - -**Get Started**: [Download Chrome Extension](https://chromewebstore.google.com/detail/ekascribe-ai-powered-clin/nncfcjgelepkhpjfkejgkncdfbcfmhom) - ---- - -### 2. 📱 **SDKs** +### 1. 📱 **SDKs** *(Recommended)* *Pre-built libraries for your applications* +We recommend the SDK approach, as it simplifies implementation by handling voice activity detection (VAD), audio chunking, uploads, and other complexities and makes it easy to plug into your existing workflow. + **What it is**: Ready-to-use code libraries that handle all the complexity **Who it's for**: Development teams building mobile apps or backend services **Requirements**: Basic development knowledge @@ -50,7 +36,7 @@ EkaScribe offers **3 different ways** to integrate voice-to-text functionality i --- -### 3. 🌐 **REST APIs** +### 2. 🌐 **REST APIs** *Direct API access for custom integrations* **What it is**: Raw HTTP endpoints that you call directly @@ -70,6 +56,22 @@ EkaScribe offers **3 different ways** to integrate voice-to-text functionality i **📖 [View Complete API Documentation →](https://developer.eka.care/api-reference/health-ai/ekascribe/ekascribe-v2/overview)** +--- + +### 3. 🔌 **Chrome Extension** +*Ready-to-use browser extension* + +**What it is**: A browser extension that works directly in Chrome +**Who it's for**: Individual doctors, clinics, or practices wanting immediate access +**Requirements**: Chrome browser only + +**How it works**: +- Install extension → Click record → Get structured medical notes +- No coding required +- Works on any website or application + +**Get Started**: [Download Chrome Extension](https://chromewebstore.google.com/detail/ekascribe-ai-powered-clin/nncfcjgelepkhpjfkejgkncdfbcfmhom) + > **Choose the integration method that works best for your setup** and start enhancing productivity while EkaScribe takes care of the documentation. diff --git a/api-reference/health-ai/ekascribe/quick-start.mdx b/api-reference/health-ai/ekascribe/quick-start.mdx new file mode 100644 index 00000000..d52fb256 --- /dev/null +++ b/api-reference/health-ai/ekascribe/quick-start.mdx @@ -0,0 +1,93 @@ +--- +title: "Quick Start" +tag: "New" +description: "A step by step guide to integrate EkaScribe into your application in just few minutes" +--- + +We recommend the SDK approach as it simplifies implementation by handling voice activity detection (VAD), audio chunking, uploads, and other complexities, making it easy to plug into your existing workflow. + +## Step 1: Get Your API Credentials + +You need a `client_id` and `client_secret` to authenticate with EkaScribe. + + + + Sign up on Eka if you haven't already. + + + Go to the Eka Developer Console, navigate to **Manage API Credentials**, and create a new client. + + + Copy your `client_id` and `client_secret`. Store them securely, the secret won't be shown again. + You can create a long live token against your client ID, which you can directly pass as an access token. + + + Use the [Client Login API](/api-reference/authorization/client-login) to obtain an access token, or use your long live token. + + + +**[View detailed authentication guide →](/api-reference/authorization/getting-started)** + +--- + +## Step 2: Install the SDK + +We recommend the **TypeScript SDK** for the fastest plug-and-play integration. + +```bash +npm install @eka-care/ekascribe-ts-sdk +# or +yarn add @eka-care/ekascribe-ts-sdk +``` + +--- + +## Step 3: Start Transcribing + +Here's a complete working example to record a consultation and get structured medical notes: + +```ts +// 1. Create a config variable to manage tokens +const sdkConfig = { + access_token: '', +}; + +// Get instance and use it throughout your application +const ekascribe = getEkaScribeInstance(sdkConfig); + +// 2. Fetch available configurations (languages, templates, etc.) +const config = await ekascribe.getEkascribeConfig(); + +// 3. Initialize a transcription session +await ekascribe.initTransaction({ + mode: 'consultation', + input_language: ['en-IN'], + output_format_template: [{ template_id: 'your_template_id' }], + txn_id: 'unique-transaction-id', + transfer: 'vaded', + model_type: 'pro', +}); + +// 4. Start recording - microphone permission will be requested +await ekascribe.startRecording(); + +// ... consultation happens ... + +// 5. Stop recording - SDK handles chunking, upload & commit automatically +await ekascribe.endRecording(); + +// 6. Get the structured output +const result = await ekascribe.pollSessionOutput({ + txn_id: 'unique-transaction-id', +}); + +console.log(result); +``` + +That's it. The SDK handles VAD, audio chunking, file uploads, retries, and polling - you just call the methods. + +--- + +## Explore Other Integration Options + +You can also integrate EkaScribe using [other SDKs](/api-reference/health-ai/ekascribe/overview#1--sdks-recommended), [REST APIs](/api-reference/health-ai/ekascribe/ekascribe-v2/overview), or the [Chrome Extension](https://chromewebstore.google.com/detail/ekascribe-ai-powered-clin/nncfcjgelepkhpjfkejgkncdfbcfmhom). diff --git a/docs.json b/docs.json index 701c6557..01ab7e50 100644 --- a/docs.json +++ b/docs.json @@ -198,47 +198,47 @@ "icon": "microphone-lines", "pages": [ "api-reference/health-ai/ekascribe/overview", - "api-reference/health-ai/ekascribe/System-Requirements", - { - "group": "EkaScribe APIs", - "icon": "microphone-lines", - "pages": [ - "api-reference/health-ai/ekascribe/ekascribe-v2/overview", - "api-reference/health-ai/ekascribe/ekascribe-v2/presigned-url", - "api-reference/health-ai/ekascribe/ekascribe-v2/file-upload", - "api-reference/health-ai/ekascribe/ekascribe-v2/init", - "api-reference/health-ai/ekascribe/ekascribe-v2/result" - ] - }, + "api-reference/health-ai/ekascribe/quick-start", { "group": "EkaScribe SDKs", "icon": "microphone-lines", "pages": [ + "api-reference/health-ai/ekascribe/SDKs/TS-sdk", "api-reference/health-ai/ekascribe/SDKs/python-sdk", "api-reference/health-ai/ekascribe/SDKs/java-sdk", "api-reference/health-ai/ekascribe/SDKs/android-sdk", - "api-reference/health-ai/ekascribe/SDKs/ios-sdk", - "api-reference/health-ai/ekascribe/SDKs/TS-sdk" + "api-reference/health-ai/ekascribe/SDKs/ios-sdk" ] }, { - "group": "APIs - DEPRECATED", + "group": "EkaScribe APIs", "icon": "microphone-lines", "pages": [ - "api-reference/health-ai/ekascribe/ekascribe-v1/upload-voice", - "api-reference/health-ai/ekascribe/ekascribe-v1/retrieve-transcribe" + "api-reference/health-ai/ekascribe/ekascribe-v2/overview", + "api-reference/health-ai/ekascribe/ekascribe-v2/presigned-url", + "api-reference/health-ai/ekascribe/ekascribe-v2/file-upload", + "api-reference/health-ai/ekascribe/ekascribe-v2/init", + "api-reference/health-ai/ekascribe/ekascribe-v2/result", + { + "group": "APIs - DEPRECATED", + "icon": "triangle-exclamation", + "pages": [ + "api-reference/health-ai/ekascribe/ekascribe-v1/upload-voice", + "api-reference/health-ai/ekascribe/ekascribe-v1/retrieve-transcribe" + ] + } ] }, "api-reference/health-ai/ekascribe/audio-transcription", { - "group": "IP Allowlisting", + "group": "System Requirements", "icon": "list-check", "pages": [ - "api-reference/health-ai/ekascribe/ip-allowlisting-for-clients" + "api-reference/health-ai/ekascribe/ip-allowlisting-for-clients", + "api-reference/health-ai/ekascribe/System-Requirements" ] }, - "api-reference/health-ai/ekascribe/FHIR/Eka-FHIR-structure", - "api-reference/health-ai/ekascribe/ip-whitelisting-for-clients" + "api-reference/health-ai/ekascribe/FHIR/Eka-FHIR-structure" ] }, {