mirror of
https://github.com/aljazceru/payments-rest-api.git
synced 2025-12-31 12:24:19 +01:00
15 lines
1.0 KiB
Markdown
15 lines
1.0 KiB
Markdown
# Breez Payments REST API
|
|
Breez Payments Rest API is a REST API on top of [Breez Nodeless SDK](https://github.com/breez/breez-sdk-liquid) build with fastapi. It enables integrations like [breez-woocommerce](https://github.com/breez/breez-woocommerce). It is built to be easily deployable anywhere, with support for providers with free tier like [fly.io](./fly/README.md).
|
|
|
|
## API documentation
|
|
OpenAPI documentation is generated on every instance at ```<api-url>/docs```. It can also be downloaded [here](./openapi.json).
|
|
|
|
## API Key Security
|
|
|
|
X-API-KEY header serves as authorization method for accessing the API. Anyone that knows the API url and API_SECRET can access your funds, so make sure to protect this secret and to generate a unique and long string. You can use generators like [this](https://1password.com/password-generator) or [this](https://www.uuidgenerator.net/).
|
|
|
|
|
|
## Deployment options
|
|
- [fly.io](./fly/README.md) - deploy fly.io app on their free tier hosting
|
|
- [self hosted](./fly/DEV.md) - deploy anywhere you want with a simple docker deployment
|