-
Notifications
You must be signed in to change notification settings - Fork 555
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
4 changed files
with
30 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,18 @@ | ||
# API v1 | ||
|
||
> ℹ️ **This is the documentation for the new API. This API is still in development and though the finished endpoints should not change please consider that breaking changes may occur once its properly released. If you are looking for the current API, please [see here](./API.md).** | ||
The new API is an ongoing effort to migrate the current API to a more modern and standard API. | ||
|
||
The main goals of this new API are: | ||
- Ease of development | ||
- Use of a [modern framework](https://gin-gonic.com) | ||
- Use of a [standard API specification](https://swagger.io/specification/) | ||
- Self-documented API using [Swag](https://github.com/swaggo/swag) | ||
- Improved authentication and sessions using [JWT](https://jwt.io) | ||
- Deduplicate code between the webserver and the API by refactoring the logic into domains | ||
- Improve testability by using interfaces and dependency injection | ||
|
||
The current status of this new API can be checked [here](https://github.com/go-shiori/shiori/issues/640). | ||
|
||
Since the API is self-docummented, you can check the API documentation by [running the server locally](./Contribute.md#running-the-server-locally) and visiting the [`/swagger/index.html` endpoint](http://localhost:8080/swagger/index.html). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters