[Fiware-iot] API open specs

Tobias Jacobs Tobias.Jacobs at neclab.eu
Fri Apr 20 16:58:41 CEST 2012


Dear Lorant, dear all,

Sorry for raising that issue again, but I want to propose yet another structure of the API specs for the IoT Broker.

How about I structure the pages for NGSI-10 (and later NGSI9) more in the style proposed in https://forge.fi-ware.eu/plugins/mediawiki/wiki/fi-ware-private/index.php/Dedicated_API_wiki_page.

We still can have a dedicated page for each API of the GE, but this would then only contain the information not already contained in the NGSI-9/10 pages.
See https://forge.fi-ware.eu/plugins/mediawiki/wiki/fi-ware-private/index.php/IoT_Broker_Northbound_API for a first example of how this could look like (still incomplete).

Otherwise the whole resource structure/table of operations would have to be repeated and maintained multiple times.
In general, I think a benefit of using standards is that their description can be centralized somewhere, so why not exploit that benefit.

Have a great weekend
Tobias


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.fiware.org/private/old-fiware-iot/attachments/20120420/5b84817f/attachment.html>


More information about the Old-Fiware-iot mailing list

You can get more information about our cookies and privacy policies clicking on the following links: Privacy policy   Cookies policy