mirror of
https://github.com/juspay/hyperswitch.git
synced 2025-10-28 04:04:55 +08:00
089a95069b
Co-authored-by: hyperswitch-bot[bot] <148525504+hyperswitch-bot[bot]@users.noreply.github.com>
46 lines
1.4 KiB
Markdown
46 lines
1.4 KiB
Markdown
# Api Reference
|
|
|
|
We use the [openapi specification](https://swagger.io/specification) for the api reference. The openapi file is generated from the code base [openapi_spec.json](openapi_spec.json).
|
|
|
|
## How to generate the file
|
|
|
|
This file is automatically generated from our CI pipeline when the PR is raised. However if you want to generate it manually, the following command can be used
|
|
|
|
```bash
|
|
cargo r -p openapi --features v2
|
|
```
|
|
|
|
## Render the generated openapi spec file
|
|
|
|
In order to render the openapi spec file, we use a tool called [mintlify](https://mintlify.com/). Local setup instructions can be found [here](https://mintlify.com/docs/development#development). Once the cli is installed, Run the following command to render the openapi spec
|
|
|
|
- Navigate to the directory where `mint.json` exists
|
|
|
|
```bash
|
|
cd api-reference-v2
|
|
```
|
|
|
|
- Run the cli
|
|
|
|
```bash
|
|
mintlify dev
|
|
```
|
|
|
|
## Add new routes to openapi
|
|
|
|
If you have added new routes to the openapi. Then in order for them to be displayed on the mintlify, run the following commands
|
|
|
|
- Switch to the directory where api reference ( mint.json ) exists
|
|
|
|
```bash
|
|
cd api-reference-v2
|
|
```
|
|
|
|
- Run the following command to generate the route files
|
|
|
|
```bash
|
|
npx @mintlify/scraping@latest openapi-file openapi_spec.json -o api-reference
|
|
```
|
|
|
|
This will generate files in [api-reference](api-reference) folder. These routes should be added to the [mint.json](mint.json) file under navigation, under respective group.
|