*Water Depth is in feet.
*Water Percentage: Water percentage must sum to 100 and must always be inserted in the URL. If the total WP number
exceeds the 100, then there's an error popup. Keep in mind that whatever the water percentage is for
one unit, the number by default will be 100 (as logically expected).
Below is a Request Example:
The value of the Request key is GetDamage, the wanted format is XML, the ID equals to 1 and so on. A
note here would be that
our URL manages the URL as case insensitive; which makes it more “hackable” and easy to manipulate,
although a case-sensitive
URL would make sense in some other applications. A more complex request:
As we can see here, we can declare multiple buildings as long as we give different ID of the type of
building. If a REST
application feels logic & normal even for the end user, then it can be said that it successfully
applies the RESTful principles.
Usually, RESTful URI’s can be described by a Regular Expression.
We can also view our REST request as a tree:
As we can see, our request is split to several parts that altogether express our initial request.
Note that this isn't the request
body -- it's just a URL. This URL is sent to the server using a simpler GET request, and the HTTP
reply is the raw result data --
not embedded inside anything, just the data you need in a way you can directly use.