OGC-IoT / ogc-iot-api

http://ogc-iot.github.io/ogc-iot-api/index.html
11 stars 3 forks source link

Not following pure REST [Comments from Xiang Su, Teemu Leppänen] #16

Closed liangsteve closed 10 years ago

liangsteve commented 10 years ago

[NOTE: This is from https://github.com/OGC-IoT/ogc-iot-api/issues/15. The above link has more than one issues. In order to make it easier to track, I decide to split them into individual issues]

About Data Model:

**One of most important things is, SensorThings API is based on REST principles. However, some cases in this document shows it does NOT follow a pure REST way. For example, in Section 4, I understand SensorThings API works in a similar way as OWS - It's a soap -like fashion, not REST. It normally be considered to be too heavy for resource-constrained devices. in Section 4.1, REST "verbs" are based on basic HTTP methods, which are considered universal. It is normally not allowed to add own vocabulary, such as filters.

liangsteve commented 10 years ago

Response: We are following the OData (v.3.0) pattern here, including the query filters. We are not inventing our own pattern. And in fact, we believe we followed all the RESTful rules. [Masse, Mark. REST API design rulebook. " O'Reilly Media, Inc.", 2011.]

We addressed this issue in the OGC Crystal City meeting, and there is a recording for the Working Group meeting as well.