Enregistrements, sessions et transcriptions

La charge utile standard Dragon contient un objet recordings, un objet sessions et un objet transcript. L’objet recordings contient des détails sur les enregistrements qui existent pour une rencontre. L’objet transcript contient la transcription complète de tous les enregistrements de la rencontre.

Exemple de charge utile

{
  "recordings": [
    {
      "recording_id": 123456,
      "status": "delivered",
      "transcript_reference": "https://api.dragoncopilot.com/transcripts/123456",
      "source": "DAXAPP",
      "template_id": "template-001",
      "start_datetime": "2025-06-18T14:00:00Z",
      "end_datetime": "2025-06-18T14:30:00Z"
    }
  ],
  "sessions": [
    {
      "dax_session_id": "f5f00a91-ffbb-43da-9540-770865fe3d76",
      "user_id": "d07bb61d-114f-439a-a678-53767f69f692",
      "organization_id": "b5a273f1-6884-406c-969b-c140f77d5078"
    }
  ],
  "transcript": {
    "speaker_count": 2,
    "turns": [
      {
        "index": 1,
        "speaker": "clinician",
        "text": "Good afternoon, how are you feeling today?",
        "start_time": "00:00:01.000",
        "end_time": "00:00:05.000"
      },
      {
        "index": 2,
        "speaker": "other",
        "text": "I'm feeling much better, thank you.",
        "start_time": "00:00:06.000",
        "end_time": "00:00:09.000"
      }
    ]
  }
}

Propriétés du schéma des enregistrements

L’objet recordings contient les propriétés suivantes :

Propriété	Type	Description	Valeurs/format autorisés
recording_id	entier	Identificateur unique de l’enregistrement. En interne, il s’agit de la session_id DAX.
status	chaîne	Cela représente l’état de l’enregistrement et le traitement des données associées à l’enregistrement.	chargement, traitement, révision, remise
transcript_reference	chaîne	URL pour récupérer la transcription d’enregistrement.	format : URI
source	chaîne	Source de l’enregistrement. Les moyens dans lesquels le signal audio ou l’entrée utilisateur a été acquis.	DAXAPP, DAXKIT.haiku, DAXKIT.teams, PMM
template_id	chaîne	ID, représenté sous la forme d’une chaîne permettant des variations d’utilisation, pour le modèle utilisé.
start_datetime	chaîne	Date et heure de début de l’enregistrement au format ISO 8601.	format : date-heure
end_datetime	chaîne	Date et heure de fin de l’enregistrement au format ISO 8601.	format : date-heure

Propriétés du schéma de session

L’objet sessions contient les propriétés suivantes :

Propriété	Type	Description	Valeurs/format autorisés
dax_session_id	chaîne	Identificateur unique de la session DAX.	format : uuid
user_id	chaîne	Identificateur unique de l’utilisateur associé à la session.	format : uuid
organization_id	chaîne	Identificateur unique de l’organisation associée à la session.	format : uuid

Propriétés du schéma de transcription

L’objet transcript contient les propriétés suivantes :

Propriété	Type	Description	Contraintes/format
speaker_count	entier	Nombre total d’orateurs uniques dans la transcription.	minimum : 1
turns	tableau	Liste des tours de parole dans la transcription.
└─ index	entier	Index séquentiel du tour.
└─ speaker	chaîne	Nom ou rôle de l’intervenant.	« clinician » ou « other »
└─ text	chaîne	Texte transcrit prononcé par l’intervenant.
└─ start_time	chaîne	Heure de début au format HH:MM:SS.sss.	modèle : ^\d{2}:\d{2}:\d{2}\.\d{3}$
└─ end_time	chaîne	Heure de fin au format HH:MM:SS.sss.	modèle : ^\d{2}:\d{2}:\d{2}\.\d{3}$