OpenApi spec for substrate-api-sidecar.
If you add a new endpoint or update an existing one (by modifying its parameters or output), you will also need to update the documentation (OpenApi specs). Here are some common steps to follow in order to do that:
- Update this file by adding or updating the corresponding endpoint description in the
pathsandschemassections. - After you complete the changes, verify that the
yamlfile has no errors by copying the contents of this file into the Swagger Editor or the New Swagger Editor. - If everything looks good, push the changes.
- To preview the docs locally, you can run
yarn build:docsfrom the root directory of this repository. This will update thedocs/dist/index.htmlpage which you can open (by copying its path) in your browser and verify that the content appear as expected. Please do not push/commit this file (or thedistfolder) in your PR since this is not necessary. The docs will be build and published automatically in Github pages from the workflow (docs.yml).