...
Properties are named in
camelCase
Any property that is for the right eye will have the prefix
rt
Any property that is for the left eye will have the prefix
lt
Any occurrence of a property for a particular resource will be the same no matter which endpoint returns it across different endpoints (so
trayNumber
is the tray number of an order is in whether you useGET /orders/123456
orGET /orders/123456/status
orPOST /orders
Validations
All incoming string parameters have a maximum length that will be documented in their description
All incoming number parameters have a maximum and minimum value that will be documented in their description
All incoming array parameters have a maximum length that will be documented in their description
If a parameter is not flagged as required it can be omitted to use default behavior particular to that field - for example, not specifying trayNumber when creating a new order will result in one being automatically generated.