Using Sails with Optic
Optic is easy to use with Sails, no special library or large code changes required.
api start
Command#
Let's say we have a simple Sails server that we usually develop with on localhost:3005.
#
Optic needs to know how to start our API and control the port it starts onOur optic.yml file would include our start command (such as sails lift --port $PORT
). The start command in this case also sets the port to which the application binds. Optic injects a $PORT
environment variable for our application to listen on when api start
is run. Sails accepts a --port
option to bind the server, and no code changes should be required.
api check start
#
Verifying with The setup tool will guide you through running checks to assure Optic is running successfully with your API project. You should see everything pass at this point. If you don't, it's most likely that you're not starting the API on the $PORT
Optic provides. The Optic check will also report any other common issues it detects and give you steps and suggestions to resolve them.
Should you need any more help, or want to chat about the process, please reach out to us. You can schedule a quick chat with the maintainers or open an issue on GitHub.
#
Run your API through OpticAt this point you should be ready to run api start
and document your API with Optic! Optic will observe your API traffic locally, and report on the routes and traffic shape it sees in the Optic dashboard. The next step is to start building your baseline specification