Giter Club home page Giter Club logo

benotes's Introduction

Benotes Logo

Benotes

Benotes Thumbnail

An open source self hosted web app for your notes and bookmarks side by side.

This project is currently in Beta. You may encounter bugs or errors.

Features

  • URLs are automatically saved with an image, title and description
  • supports both markdown and a rich text editor
  • can be installed as a PWA on your mobile devices (and desktop)
  • collections can be shared via a public available URL
  • links can be pasted (by pressing only one button)
  • can be hosted almost anywhere thanks to its use of the lightweight Lumen framework and well supported PHP language

Installation & Upgrade

Currently their are three options for you two choose from:


Feel free to contact me if you need any help or open an issue.

Rest API

Authentication

POST /api/auth/login

Logs in a user

Attribute Value
email Required.
password Required.

POST /api/auth/refresh

Refreshes the JWT Token

GET /api/auth/me

Returns the authenticated user

POST /api/auth/logout

Logs out the authenticated user


Posts

GET /api/posts

Get multiple posts

Attribute Value
collection_id Optional. Specify a collection of which you want to request posts. If collection_id is not specified you will get all posts from all collections from your user
is_uncategorized Optional. Specify if you wish to get all posts without a collection.
limit Optional. Limit the amount of requested posts by number

GET /api/posts/{id}

Get one post by its id

POST /api/posts

Create a new post

Attribute Value
collection_id Optional. Specify a collection you wish to save your new post to, if not, your post will not be part of a collection.
title Optional. Specify a title, gets automatically filled if your content is a link
content Required. Specify a link, post, message, ..

PATCH /api/posts/{id}

Update an existing post

Attribute Value
collection_id Optional. Specify a collection you want to save your post to instead. To patch a post from the uncategorized collection simply use 0 as value for the collection_id
title Optional. Change your posts title
content Optional. Change your posts content
order Optional. Specify a new order you wish to move your post to

DELETE /api/posts/{id}

Delete a post by its id

benotes's People

Contributors

fr0tt avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.