API-Dokumentation ⋅ Plume Dokumentation

Ein API Token bekommen

Um Zugriff auf die API zu erhalten, sollten Sie Ihre App registrieren und dann einen Token erhalten. Dazu verwenden Sie die API /api/v1/apps (zugänglich ohne einen Token) um eine neue App zu erstellen. Speichern Sie das Ergebnis irgendwo für die zukünftige Verwendung.

Dann senden Sie eine Anfrage an /api/v1/oauth2, mit den folgenden GET-Parametern:

client_id, deine Client-ID.
client_secret, dein Client-Secret.
Scopes, die Scopes, auf die du zugreifen möchtest. Diese können getrennt sein von + und können read (global lesen), write (global schreiben), read:SCOPE (lese nur in SCOPE) oder write:SCOPE (schreibe nur in SCOPE).
username der Benutzername (nicht die E-Mail, Anzeigename oder der voll qualifizierte Name) des Benutzers ihrer App.
password, das Passwort des Benutzers.

Plume wird mit etwas Ähnlichem antworten:

{
  "token" "<YOUR TOKEN HERE>
}

Um Ihre Anfragen zu authentifizieren, sollten Sie diesen Token in den Authorization Header legen:

Autorisierung: Bearer <YOUR TOKEN HERE>