🦷 Dental SOAP API

Overview

The Dental SOAP API processes audio recordings from dental consultations and returns structured SOAP (Subjective, Objective, Assessment, Planning) notes along with transcription and optional dentist evaluation.

Authentication

All API requests require authentication using an API key. Include your API key in the request header:

X-API-Key: dsk_your_api_key_here

Endpoints

curl -X POST https://dentalaidavid.ftp.sh/api/v1/soap \
  -H "X-API-Key: dsk_your_api_key" \
  -F "audio=@recording.wav"

{
  "success": true,
  "data": {
    "transcription": "Pasien mengeluh gigi belakang kanan bawah sakit sejak 3 hari...",
    "soap": {
      "subjective": "Pasien mengeluh nyeri pada gigi posterior kanan bawah...",
      "objective": "Gigi 46 tampak karies profunda...",
      "assessment": "Pulpitis irreversible gigi 46",
      "planning": "1. Perawatan saluran akar gigi 46..."
    },
    "dentist_evaluation": {
      "has_conversation": true,
      "score": 85,
      "comment": "Dokter menunjukkan empati yang baik...",
      "improvement": "Dapat lebih menjelaskan prosedur..."
    }
  },
  "usage": {
    "used_today": 5,
    "daily_limit": 100
  }
}

curl -X GET https://dentalaidavid.ftp.sh/api/v1/usage.php \
  -H "X-API-Key: dsk_your_api_key"

{
  "success": true,
  "data": {
    "plan": "unlimited",
    "daily_limit": "unlimited",
    "usage": {
      "requests_today": 5,
      "requests_this_month": 42,
      "requests_total": 150,
      "minutes_today": 12.5,
      "minutes_this_month": 95.3,
      "minutes_total": 320.8
    }
  }
}

Code Examples

Python

import requests

url = "https://dentalaidavid.ftp.sh/api/v1/soap"
headers = {"X-API-Key": "dsk_your_api_key"}

with open("recording.wav", "rb") as audio_file:
    response = requests.post(url, headers=headers, files={"audio": audio_file})
    
data = response.json()
print(data["data"]["soap"]["subjective"])

JavaScript (Node.js)

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const form = new FormData();
form.append('audio', fs.createReadStream('recording.wav'));

const response = await axios.post('https://dentalaidavid.ftp.sh/api/v1/soap', form, {
    headers: {
        'X-API-Key': 'dsk_your_api_key',
        ...form.getHeaders()
    }
});

console.log(response.data.data.soap);

PHP

$ch = curl_init('https://dentalaidavid.ftp.sh/api/v1/soap');

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: dsk_your_api_key'],
    CURLOPT_POSTFIELDS => ['audio' => new CURLFile('recording.wav')]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

echo $data['data']['soap']['subjective'];

JavaScript SDK (Recommended)

The easiest way to integrate - just add our SDK and your users can record directly from your website!

Quick Start (3 lines of code!)

<!-- 1. Add the SDK -->
<script src="https://dentalaidavid.ftp.sh/sdk/dental-soap.js"></script>

<!-- 2. Add a button -->
<button id="recordBtn">🎤 Record SOAP</button>

<!-- 3. Initialize -->
<script>
DentalSOAP.init({
    apiKey: 'dsk_your_api_key',
    buttonId: 'recordBtn',
    onSuccess: function(data) {
        console.log('SOAP:', data.data.soap);
        console.log('Transcription:', data.data.transcription);
    },
    onError: function(error) {
        alert('Error: ' + error.message);
    }
});
</script>

Complete Widget (Auto-renders UI)

Let the SDK create the entire UI for you:

<div id="soap-widget"></div>

<script src="https://dentalaidavid.ftp.sh/sdk/dental-soap.js"></script>
<script>
DentalSOAP.init({ apiKey: 'dsk_your_api_key' });
DentalSOAP.createWidget('soap-widget');
</script>

SDK Options

Response Data Structure

{
  "success": true,
  "data": {
    "transcription": "Full transcription text...",
    "soap": {
      "subjective": "...",
      "objective": "...",
      "assessment": "...",
      "planning": "..."
    },
    "dentist_evaluation": {
      "has_conversation": true,
      "score": 85,
      "comment": "...",
      "improvement": "..."
    }
  }
}

Support

For questions or issues, contact us at daveldede@gmail.com