Initiate Smart Symptom Checker
Once you have requested and received your Access Token here a conversation can be started with the Smart Symptom Checker.
Start a conversation
To start a new conversation, either a request should be made to the chat
endpoint, providing a number of mandatory key/value pairs in the answer
object, or end empty JSON as the first message and we will ask name, gender, age and initial symptoms in the consultation flow.
Body
Request body schema: application/json
Key | Type | Description |
---|---|---|
type | string | Must be string "entry" |
name | string | Name of the person symptom check is for |
gender | string | Gender of the person symptom check is for. Must be either "male" or "female" |
year_of_birth | integer | Year of birth of the person symptom check is for. Must be in a four-digit format, e.g. 1978 |
initial_symptom | string | Symptom(s) being experienced. Multiple symptoms can be separated using "and", e.g. "shaking and coughing" It is recommended that this is used in conjunction with the Symptom Search endpoint. |
other | Boolean | Denotes whether this conversation is for the current user (false) or someone else (true) |
Example request:
curl -X POST https://portal.your.md/v4/chat \
-H "Authorization: eyJraWQiOi10Y2RmY2Q0OS1kM2QyJFRlZGMtYThlZi02MDY5ZjRmZWYwNmMiLCJhbFhiOiJSUzI1NiJ9.eyJzdWIiOiJ5bWRNb3JzZV9pcGp6ZlRtMmwwRlhvd01zaXBIaWlObGZmZVlLb1ZPeWZmcmhyYmJpcGlzN2pXSlkiLCJlbWFpbF92ZXJpZmllZCI6ZmFsc2UsImRldmljZV9pZCI6InBhcnRuZXJfcmFtcF83NDdlNWE0OTlkNTYzNjI0ZGFjMjBmYTQ4NGU1ZjQwMzczYmNiODg5YmI2NzIzYzRmNTExMjgyOTY0NmFlZWI2IiwiaXNzIjoieW1kLWludGVybmFsLXNlcnZpY2UtcHJvZCIsImp0aSI6ImZiMmNjZjJiLTNlZDYtNGRkMi04NWY4LWM1NThiODUxN2U3ZCIsImlhdCI6MTY0Nzg2MjAxOSwiZXhwIjoxNjQ3ODYzODE5fQ.rLQknhj00FvBI6fAKOcutyE3kpcO9PSJI60-PGynuU-rpAGVFXGl3oJQjlmEiJdj6cm3_bGqJbZUFXiJ56eDUwJ13coLTcQwoBPwAf2tActpJnjRMJivCB_b_sialoYRH0OZkiOysmEV01L4aHq8R535UpVlY4U-wxhhD7JYhLpo-e9BRbl2EgQhuFXLzl3s4ZPCSH7yMLn5KqfJIgcCoqL2f6nduZbFVXeKCmMjh5F2hs6QdKZPbBBVZBG9an6ACncvnwgqvUC00CmzEh76znjI8Xxeq1wSmwNYpBXQS3mPjUCpJAXIk5kjCSucu0BHngHYYBU3tL4Ifcs-vhgLqQ" \
-H "x-api-key: GrNh3vPVdckgA9mCHxdmaSM2ucaywMZ9HbRJ1qTa"\
-H "Content-Type: application/json" -d '
{
"answer": {
"type": "entry",
"name": "Tim",
"gender": "male",
"year_of_birth": 1978,
"initial_symptom": "shaking and coughing",
"other": false
}
}'
Depending on the initial symptom(s) provided during the initiation, the API will either immediately start an Assessment Flow or provide the user with a choice of Assessment or Information.
Updated almost 2 years ago
What’s Next