Utilisation Endpoint

Le service est accessible via le point de terminaison /analyser ou /parse. Il renvoie Il renvoie une liste de mentions qui ont été reconnues dans le message. Notre technologie de langage est également capable de repérer certaines mentions négatives (comme dans «Je n'ai pas de mal de tête») et de traiter les fautes d'orthographe (un problème courant dans le langage du chat).

Le point de terminaison attend un JSON simple contenant un attribut obligatoire, nommé texte. Voici un exemple :

curl "https://api.tdoct.com/v1/parse" \

-X "POST" \

-H "App-Id: XXXXXXXX" -H "App-Key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \

-H "Content-Type: application/json" \

-d '{"text": "i feel smoach pain but no couoghing today", "age": {"value": 20}}}'

Et la réponse:

{

"mentions": [

{

  "id": "s_13",

  "orth": "stomach pain",

  "choice_id": "present",

  "name": "Abdominal pain",

  "common_name": "Abdominal pain",

  "type": "symptom"

},

{

  "id": "s_102",

  "orth": "coughing",

  "choice_id": "absent",

  "name": "Cough",

  "common_name": "Cough",

  "type": "symptom"

}

],

"obvious": false

}

Chaque mention est associée à un identifiant de concept (idattribut) et à une modalité (present ou à absent l'attribut nommé choice_id). Ces attributs sont directement compatibles avec le point de terminaison/diagnostique.

L'attribut  name contient le nom principal d'un symptôme ou d'un facteur de risque, tel qu'utilisé par les professionnels de la santé. Le champ common_name porte un équivalent du nom principal mais écrit en anglais simple, ce qui le rend plus approprié pour le grand public (par exemple mal de gorge vs douleur pharyngée). Dans de nombreux cas, les deux champs ont la même valeur.

Le troisième attribut portant le nom, orth contient la forme orthographique de la mention, c'est-à-dire les mots utilisés dans le texte (après correction orthographique).