API PerioMeasures
See Perio Chart for more information.
A PerioMeasure stores measurements for a single tooth in a PerioExam. One tooth can have multiple PerioMeasures on a single exam, but only one of each SequenceType. Different SequenceTypes have different ranges of measurements that ToothValue and Surface Values (MBvalue, Bvalue, DBvalue, MLvalue, Lvalue, and DLvalue) can contain. When a SequenceType allows Surface Values, at least one of the six values must contain a measurement. Values of -1 indicate no measurement. Values greater than 100 indicate negative values (Example: To use a value of 105, subtract it from 100. [100 - 105 = -5]).
Version Added: 22.4.32
Gets a list of PerioMeasures.
PerioExamNum: Optional. FKey to perioexam.PerioExamNum. Use to get all measurements for a single exam.
Returned fields are detailed below:
SequenceType: Specifies what is being measured.
IntTooth: The tooth this measurement is associated to.
ToothValue: Used when the measurement does not apply to a surface.
MBvalue: Mesial Buccal surface value.
Bvalue: Buccal surface value.
DBvalue: Distal Buccal surface value.
MLvalue: Mesial Lingual surface value.
Lvalue: Lingual surface value.
DLvalue: Distal Lingual surface value.
SecDateTEdit: When this PerioMeasure was last modified.
Example Requests:
GET /periomeasures
GET /periomeasures?PerioExamNum=3
Example Response:
[
{
"PerioMeasureNum": 66,
"PerioExamNum": 3,
"SequenceType": "SkipTooth",
"IntTooth": 16,
"ToothValue": 1,
"MBvalue": -1,
"Bvalue": -1,
"DBvalue": -1,
"MLvalue": -1,
"Lvalue": -1,
"DLvalue": -1,
"SecDateTEdit": "2023-03-15 11:35:22"
},
{
"PerioMeasureNum": 96,
"PerioExamNum": 3,
"SequenceType": "Probing",
"IntTooth": 17,
"ToothValue": -1,
"MBvalue": 3,
"Bvalue": 3,
"DBvalue": 3,
"MLvalue": 3,
"Lvalue": 2,
"DLvalue": 3,
"SecDateTEdit": "2023-03-15 11:44:14"
},
{
"PerioMeasureNum": 97,
"PerioExamNum": 3,
"SequenceType": "Bleeding",
"IntTooth": 2,
"ToothValue": -1,
"MBvalue": 0,
"Bvalue": 15,
"DBvalue": 15,
"MLvalue": 0,
"Lvalue": 0,
"DLvalue": 0,
"SecDateTEdit": "2023-03-15 11:50:14"
},
etc...
]
200 OK
400 BadRequest
404 NotFound "PerioExamNum not found"
Version Added: 22.4.37
Inserts a new PerioMeasure. New periomeasures are compared against existing periomeasures attached to the same perioexam to prevent duplicates.
PerioExamNum: Required. FK to PerioExam.PerioExamNum.
SequenceType: Required. Either "Mobility", "Furcation", "GingMargin", "MGJ", "Probing", "SkipTooth", or "Bleeding".
IntTooth: Required. Valid values are 1-32. The tooth that this measurement is associated to.
ToothValue, MBvalue, Bvalue, DBvalue, MLvalue, Lvalue, DLvalue: See the top of this page for more information. Relies on SequenceType. Default -1.
Example Requests:
POST /periomeasures
{
"PerioExamNum": 5,
"SequenceType": "Probing",
"IntTooth": 8,
"MBvalue": 2,
"Bvalue": 3,
"DBvalue": 2,
"MLvalue": 2,
"Lvalue": 2,
"DLvalue": 2
}
or
{
"PerioExamNum": 5,
"SequenceType": "Mobility",
"IntTooth": 9,
"ToothValue": 4
}
Example Responses:
{
"PerioMeasureNum": 206,
"PerioExamNum": 5,
"SequenceType": "Probing",
"IntTooth": 8,
"ToothValue": -1,
"MBvalue": 2,
"Bvalue": 3,
"DBvalue": 2,
"MLvalue": 2,
"Lvalue": 2,
"DLvalue": 2,
"SecDateTEdit": "2023-03-30 11:20:02"
}
or
{
"PerioMeasureNum": 207,
"PerioExamNum": 5,
"SequenceType": "Mobility",
"IntTooth": 9,
"ToothValue": 4,
"MBvalue": -1,
"Bvalue": -1,
"DBvalue": -1,
"MLvalue": -1,
"Lvalue": -1,
"DLvalue": -1,
"SecDateTEdit": "2023-03-30 11:23:31"
}
201 Created
400 BadRequest (with explanation)
404 NotFound (with explanation)
Version Added: 22.4.37
Updates an existing PerioMeasure. The following fields cannot be set as part of a PUT: PerioMeasureNum, PerioExamNum, SequenceType, and IntTooth. Attempts to set them will be silently ignored.
PerioMeasureNum: Required in the URL. Primary key.
ToothValue, MBvalue, Bvalue, DBvalue, MLvalue, Lvalue, DLvalue: The values that can be supplied and the measurements they can contain rely on the SequenceType. See the top of this page for more information.
Example Requests:
PUT /periomeasures/206
{
"MBvalue": 3,
"Bvalue": 2,
"DBvalue": 3,
"MLvalue": 3,
"Lvalue": 2,
"DLvalue": 3
}
or
{
"ToothValue": 4
}
Example Responses:
{
"PerioMeasureNum": 206,
"PerioExamNum": 5,
"SequenceType": "Probing",
"IntTooth": 8,
"ToothValue": -1,
"MBvalue": 3,
"Bvalue": 2,
"DBvalue": 3,
"MLvalue": 3,
"Lvalue": 2,
"DLvalue": 3,
"SecDateTEdit": "2023-04-05 14:30:00"
}
or
{
"PerioMeasureNum": 207,
"PerioExamNum": 5,
"SequenceType": "Mobility",
"IntTooth": 9,
"ToothValue": 4,
"MBvalue": -1,
"Bvalue": -1,
"DBvalue": -1,
"MLvalue": -1,
"Lvalue": -1,
"DLvalue": -1,
"SecDateTEdit": "2023-04-03 09:48:23"
}
201 OK
400 BadRequest (with explanation)
404 NotFound (with explanation)