Skip to content

Learn-iot/api-designer

 
 

Repository files navigation

api-designer console for oic api.

A graphical, web based tool from [MuleSoft] (https://www.mulesoft.com/platform/api/api-designer) that is adapted to syncs with OIC's [IoTDataModels] (https://github.com/OpenInterConnect/IoTDataModels) to document the APIs in a human friendly interactive console and makes it easy to engage fellow application developers.

API Designer is a standalone/embeddable editor for RAML (RESTful API Modeling Language) written in JavaScript using Angular.JS. By default, the editor uses an in-browser filesystem stored in HTML5 Localstorage. This version has been modified to pull content directly from github.

Usage

The console has also been modified to take some parameters from the query string. Currently supported keys are:

  • 'gitRepo' : The path to the repo which is constructed as :owner/:repo.
    • Example: OpenInterConnect/IoTDataModels
  • 'gitPath' : the content path under which the content will be pulled recursively (usually empty).
    • Example: .
  • 'gitRef' : The name of the commit/branch/tag. Default: the repository’s default branch (usually master).
    • Example: OIC-Release-1.0.0

Resulting examples:

https://cdn.rawgit.com/OpenInterConnect/api-designer/master/raml-designer-4-git.html?gitRepo=OpenInterConnect/IoTDataModels&gitRef=OIC-Release-1.0.0
https://cdn.rawgit.com/OpenInterConnect/api-designer/master/raml-designer-4-git.html?gitRepo=OpenInterConnect/IoTDataModels
https://cdn.rawgit.com/OpenInterConnect/api-designer/master/raml-designer-4-git.html?gitRepo=mulesoft/api-console&gitPath=dist/examples

License

[CPAL-1.0] (https://opensource.org/licenses/CPAL-1.0)

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 58.5%
  • JavaScript 38.5%
  • CSS 3.0%