1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
# Karakeep SDK
This package contains the official typescript SDK for the karakeep API.
## Installation
```
npm install @karakeep/sdk
```
## Usage
```typescript
import { createHoarderClient } from "@karakeep/sdk";
// Create a client
const apiKey = "my-super-secret-key";
const addr = `https://karakeep.mydomain.com`;
const client = createHoarderClient({
baseUrl: `${addr}/api/v1/`,
headers: {
"Content-Type": "application/json",
authorization: `Bearer ${apiKey}`,
},
});
// Create a bookmark
const {
data: createdBookmark,
response: createResponse,
error: createError,
} = await client.POST("/bookmarks", {
body: {
type: "text",
title: "Search Test 1",
text: "This is a test bookmark for search",
},
});
console.log(createResponse.status, createdBookmark, createError);
// Search for bookmarks
const {
data: searchResults,
response: searchResponse,
error: searchError,
} = await client.GET("/bookmarks/search", {
params: {
query: {
q: "test bookmark",
},
},
});
console.log(searchResponse.status, searchResults, searchError);
```
## Docs
API docs can be found [here](https://docs.karakeep.app/api).
## Versioning
- This package follows the minor version of the karakeep server. So new APIs introduced in Karakeep version `0.21.0` will be available in this package starting from version `0.21.0`.
- Karakeep strives to maintain backward compatibility in its APIs, so older versions of this package should continue working with newer karakeep server versions.
|
