From e9227ca91aabc0903d564157eb72e19dd14932bb Mon Sep 17 00:00:00 2001 From: webzwo0i Date: Sun, 14 Apr 2024 02:15:11 +0200 Subject: [PATCH] chore: add docs how to obtain bearer token --- doc/api/http_api.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/api/http_api.md b/doc/api/http_api.md index ffaa3af37..27c0a2786 100644 --- a/doc/api/http_api.md +++ b/doc/api/http_api.md @@ -161,7 +161,7 @@ Responses are valid JSON in the following format: ### Authentication -Authentication works via an OAuth token that is sent with each request as a post parameter. You can add new clients that can sign in via the API by adding new entries to the sso section in the settings.json. +Authentication works via an OAuth token that is sent with each request as an Authorization header, i.e. `Authorization: Bearer YOUR_TOKEN`. You can add new clients that can sign in via the API by adding new entries to the sso section in the settings.json. #### Example for browser login clients @@ -200,6 +200,10 @@ E.g. a service that creates a pad for a user or a service that inserts a text in } ``` +Obtain a Bearer token: + +`curl --request POST --url 'https://your.server.tld/oidc/token' --header 'content-type: application/x-www-form-urlencoded' --data grant_type=client_credentials --data client_id=client_credentials --data client_secret=client_credentials` + ### Node Interoperability