Skip to content

Latest commit

 

History

History
77 lines (52 loc) · 3.66 KB

File metadata and controls

77 lines (52 loc) · 3.66 KB

Go Version API Version OpenAPI Gin Framework

Better Stack Badge Made with Love

codecov (Target: 80%+)

📖 Overview

The Stayforge API provides programmatic access to the Stayforge platform via a RESTful interface. This repository serves as the official documentation hub and issue tracker.

Quick Links

How to get a APIKey?

Manage your keys in here: https://dash.stayforge.io/settings/apikeys

Then, Put APIKey to Header X-API-Key:

curl -X GET "https://api.stayforge.net/v1/endpoint" \
     -H "X-API-Key: YOUR_API_KEY_HERE" \
     -H "Content-Type: application/json"

About OpenAPI & SDK

We are currently developing official SDKs for multiple languages, including Node.js, Python, Go, Java, and C#, all generated from and strictly aligned with this OpenAPI specification.

openapi.json / openapi.yaml

Before the official SDKs are released, you can already start integrating with our APIs by leveraging community-maintained OpenAPI tooling. In particular, for TypeScript projects, we recommend using openapi-typescript to generate type-safe client definitions directly from our OpenAPI schema, enabling rapid and reliable development.

Tip

Need help or found a bug?

For real-time support, join our Discord.

To report bugs or documentation inconsistencies, please open a GitHub Issue.


🛠 What You’ll Find Here

  • 📄 Documentation Metadata – Links and schemas for the official Stayforge API.
  • 🐛 Issue Tracking – A centralized place to report bugs or unclear API behavior.
  • Feedback – Suggestions for improving examples or explanations.

🚀 Contributing & Issues

We welcome contributions to improve our documentation!

Submitting Issues

Please use our Issue Templates for:

  • Bug Report — For errors or inconsistencies in the documentation.
  • Feature Request — For suggestions or improvements.
  • Documentation Issue — For unclear, missing, or misleading documentation.

Workflow

  1. Fork the repository.
  2. Make changes (Markdown or schema updates).
  3. Open a Pull Request with a clear description of the improvement.

🛡 License

Stayforge API Documentation is maintained by the Stayforge Team.