vikunja
/
go-sdk
Archived
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Updated readme

This commit is contained in:
kolaente 2019-10-19 22:59:00 +02:00
parent d1bd0237ad
commit 134775085f
Signed by: konrad
GPG Key ID: F40E70337AB24C9B
1 changed files with 32 additions and 36 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

68
README.md
View File

@ -1,19 +1,44 @@
# Go API client for swagger # Go API client for vikunja
This is the documentation for the [Vikunja](http://vikunja.io) API. Vikunja is a cross-plattform Todo-application with a lot of features, such as sharing lists with users or teams. <!-- ReDoc-Inject: <security-definitions> --> # Authorization **JWT-Auth:** Main authorization method, used for most of the requests. Needs `Authorization: Bearer <jwt-token>`-header to authenticate successfully. **BasicAuth:** Only used when requesting tasks via caldav. <!-- ReDoc-Inject: <security-definitions> --> This is the documentation for the [Vikunja](http://vikunja.io) API. Vikunja is a cross-plattform Todo-application with a lot of features, such as sharing lists with users or teams.
## Overview ## Overview
This API client was generated by the [swagger-codegen](https://github.com/swagger-api/swagger-codegen) project. By using the [swagger-spec](https://github.com/swagger-api/swagger-spec) from a remote server, you can easily generate an API client. This API client was generated by the [swagger-codegen](https://github.com/swagger-api/swagger-codegen) project. By using the [swagger-spec](https://github.com/swagger-api/swagger-spec) from a remote server, you can easily generate an API client.
- API version: 0.8+21-854fde1e4c * API version: 0.8+21-854fde1e4c
- Package version: 1.0.0
- Build package: io.swagger.codegen.languages.GoClientCodegen ## Authorization
For more information, please visit [http://vikunja.io/en/contact/](http://vikunja.io/en/contact/)
* **JWT-Auth:** Main authorization method, used for most of the requests. Needs `Authorization: Bearer <jwt-token>`-header to authenticate successfully.
* **BasicAuth:** Only used when requesting tasks via caldav.
#### HTTP basic authentication
```
auth := context.WithValue(context.Background(), sw.ContextBasicAuth, sw.BasicAuth{
UserName: "username",
Password: "password",
})
r, err := client.Service.Operation(auth, args)
```
#### JWTKeyAuth - API key
```
auth := context.WithValue(context.Background(), sw.ContextAPIKey, sw.APIKey{
Key: "APIKEY",
Prefix: "Bearer", // Omit if not necessary.
})
r, err := client.Service.Operation(auth, args)
```
## Installation ## Installation
Put the package under your project folder and add the following in import: Put the package under your project folder and add the following in import:
``` ```
"./swagger" go get -u code.vikunja.io/go-sdk
``` ```
## Documentation for API Endpoints ## Documentation for API Endpoints
@ -135,32 +160,3 @@ Class | Method | HTTP request | Description
- [V1VikunjaInfos](docs/V1VikunjaInfos.md) - [V1VikunjaInfos](docs/V1VikunjaInfos.md)
## Documentation For Authorization
## BasicAuth
- **Type**: HTTP basic authentication
Example
```
auth := context.WithValue(context.Background(), sw.ContextBasicAuth, sw.BasicAuth{
UserName: "username",
Password: "password",
})
r, err := client.Service.Operation(auth, args)
```
## JWTKeyAuth
- **Type**: API key
Example
```
auth := context.WithValue(context.Background(), sw.ContextAPIKey, sw.APIKey{
Key: "APIKEY",
Prefix: "Bearer", // Omit if not necessary.
})
r, err := client.Service.Operation(auth, args)
```
## Author
hello@vikunja.io