mirror of
https://github.com/laurent22/joplin.git
synced 2024-12-24 10:27:10 +02:00
25 lines
1.3 KiB
Markdown
25 lines
1.3 KiB
Markdown
# Clipper authorisation mechanism
|
|
|
|
In order to access the clipper API, the client must use a token, which is a random string generated by the application.
|
|
|
|
There are two ways for applications to obtain this token:
|
|
|
|
## Get it from the user
|
|
|
|
The user can copy the token in the Clipper configuration page and provide it directly to the application. This is the simplest method.
|
|
|
|
## Request it programmatically
|
|
|
|
The token can also be requested programmatically, as is done for the web clipper extension. It works as below:
|
|
|
|
- The client calls `POST /auth`. The server responds with `{ auth_token: "AUTH_TOKEN" }`. This `auth_token` is different from the regular token - it is just used to authenticate the client.
|
|
|
|
- The application displays a message asking the user to Accept or Reject the access request.
|
|
|
|
- The clients calls `GET /auth/check?auth_token=AUTH_TOKEN` at regular intervals. Initially the server responds with `{ status: "waiting" }`, since we are waiting for the user to confirm or reject.
|
|
|
|
- Once the user accepts the request in the application, the server returns `{ status: "accepted", token: "API_TOKEN" }`.
|
|
|
|
- The client can now use this `API_TOKEN` to make requests.
|
|
|
|
- If the users rejects the request, the server returns `{ status: "rejected" }`, and the client can display an error message. |