Rebilly OpenAPI Definitions
- Our website (www.rebilly.com) is powered by the Redocly Portal.
- Our API reference is powered by Redocly API docs.
TBD: Add Redocly validation status badge.
Links
- Core API docs
- Users API docs
- Reports API docs
- Storefront API docs (this API is in development and subject to change)
Contributing
Environment setup
If you use VS Code, use the Redocly VS Code extension to edit this repo and get inline lint feedback and previews.
Install
- Install Node JS (version 14 or more recent)
- Clone repo and run
npm ci
in the repo root
Usage
Preview
This process describes how to start a development server docs preview for the Rebilly API docs. Changes made to the API specification while the development server is running are immediately displayed in the docs preview.
Rebilly uses Redocly to generate, manage, and preview API docs.
- In a terminal, install the Redocly CLI.
Use this command to install the package globally on your machine:npm install @redocly/cli -g
- Sign in or create a Redocly account.
If you are a Rebilly employee, sign in using SSO and your Rebilly email address. - In Redocly, in the top right of the screen, click your name, then click My profile.
- In the Personal API keys section, click Add API key.
- Enter an API key name, then click Save.
- Copy the API key.
- In a terminal, execute the following command:
redocly login
. - When prompted, paste your API key.
- Execute one of the following commands to start a development server docs preview:
- Core API docs:
redocly preview-docs core@latest
- All API docs:
redocly preview-docs all@latest
- Core API docs:
- In a web browser, open the preview server URL that is displayed in the terminal.
Build
Run npm run build
to bundle the definitions into a single file in the dist
folder.
Validate
Run npx redocly lint
to validate the definitions.