Skip to content

Joplin API

Introduction

TypeScript encapsulation of the Joplin data API for use in both plugins and standalone applications.

Usage

ts
import { joplinDataApi } from 'joplin-api'

const api = joplinDataApi({
  type: 'rest',
  baseUrl: 'http://127.0.0.1:27583',
  token: '***',
})
// or in plugin
const api = joplinDataApi({
  type: 'plugin',
})

const res = await api.note.list()
console.log(res)

For more examples, refer to: https://github.com/rxliuli/joplin-utils/tree/master/packages/joplin-api/src/api/__tests__

API Reference

ObjectDescription
api.eventEvent-related API, such as getting note modification history
api.folderFolder-related API, such as getting the directory tree
api.folderExtFolder extension API, such as moving directories
api.joplinBasic Joplin API, such as checking if Joplin web service is open
api.noteActionNote action related API, such as opening notes in an external editor
api.noteNote-related API, such as getting note content
api.noteExtNote extension API, such as renaming notes
api.resourceActionResource action API, such as opening resources in an external editor
api.resourceResource-related API, such as uploading images
api.searchSearch-related API
api.tagTag-related API, such as modifying note tags
PageUtilStatic utility class for pagination, such as getting a full list of notes

API Documentation

Released under the MIT License.