From e2f293ec373da56432e31a684c27d52424585651 Mon Sep 17 00:00:00 2001 From: Elian Doran Date: Thu, 30 Oct 2025 09:30:58 +0200 Subject: [PATCH] Updated ETAPI (markdown) --- ETAPI.md | 28 +--------------------------- 1 file changed, 1 insertion(+), 27 deletions(-) diff --git a/ETAPI.md b/ETAPI.md index 18f62cb..edf7d61 100644 --- a/ETAPI.md +++ b/ETAPI.md @@ -1,27 +1 @@ -ETAPI is Trilium's public/external REST API. It is available since Trilium v0.50. - -The documentation is in OpenAPI format, available [here](https://github.com/TriliumNext/Trilium/blob/main/apps/server/src/assets/etapi.openapi.yaml). - -[trilium-py](https://github.com/Nriver/trilium-py) is a third-party Python implementation for ETAPI client, you can use Python to communicate with Trilium. - -## Authentication - -All operations have to be authenticated using a token. You can get this token either from Options -> ETAPI or programmatically using the `/auth/login` REST call (see the [spec](https://github.com/TriliumNext/Trilium/blob/main/apps/server/src/assets/etapi.openapi.yaml)): - -``` -GET https://myserver.com/etapi/app-info -Authorization: ETAPITOKEN -``` - -Alternatively, since 0.56 you can also use basic auth format: - -``` -GET https://myserver.com/etapi/app-info -Authorization: Basic BATOKEN -``` - -* Where `BATOKEN = BASE64(username + ':' + password)` - this is a standard Basic Auth serialization -* Where `username` is "etapi" -* And `password` is the generated ETAPI token described above. - -Basic Auth is meant to be used with tools which support only basic auth. \ No newline at end of file +See https://docs.triliumnotes.org/user-guide/advanced-usage/etapi. \ No newline at end of file