docs

package
v2.4.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 17, 2023 License: CC-BY-4.0, MIT Imports: 4 Imported by: 0

Documentation

Overview

Package docs Gotify REST-API.

This is the documentation of the Gotify REST-API.

# Authentication
In Gotify there are two token types:
__clientToken__: a client is something that receives message and manages stuff like creating new tokens or delete messages. (f.ex this token should be used for an android app)
__appToken__: an application is something that sends messages (f.ex. this token should be used for a shell script)

The token can be transmitted in a header named `X-Gotify-Key`, in a query parameter named `token` or
through a header named `Authorization` with the value prefixed with `Bearer` (Ex. `Bearer randomtoken`).
There is also the possibility to authenticate through basic auth, this should only be used for creating a clientToken.

\---

Found a bug or have some questions? [Create an issue on GitHub](https://github.com/gotify/server/issues)

    Schemes: http, https
    Host: localhost
    Version: 2.0.2
    License: MIT https://github.com/gotify/server/blob/master/LICENSE

    Consumes:
    - application/json

    Produces:
    - application/json

    SecurityDefinitions:
       appTokenQuery:
          type: apiKey
          name: token
          in: query
       clientTokenQuery:
          type: apiKey
          name: token
          in: query
	      appTokenHeader:
          type: apiKey
          name: X-Gotify-Key
          in: header
	      clientTokenHeader:
          type: apiKey
          name: X-Gotify-Key
          in: header
	      appTokenAuthorizationHeader:
          type: apiKey
          name: Authorization
          in: header
          description: >-
              Enter an application token with the `Bearer` prefix, e.g. `Bearer Axxxxxxxxxx`.
	      clientTokenAuthorizationHeader:
          type: apiKey
          name: Authorization
          in: header
          description: >-
              Enter a client token with the `Bearer` prefix, e.g. `Bearer Cxxxxxxxxxx`.
       basicAuth:
          type: basic

swagger:meta

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Serve

func Serve(ctx *gin.Context)

Serve serves the documentation.

func UI

func UI(ctx *gin.Context)

UI serves the swagger ui.

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL