softlion/notionsharp

Notion API client library in C# (csharp)

NotionSharp - Notion API client for C#

Notion is an app to write things. It has the most simple "wysiwyg" editor i have ever seen. Add photo, video, tables and more in one drag/drop or one click. For devs it features code blocks with highlightning.
The app works both offline and online, is multi user and historize all your changes making it easy to revert them.
The app is also available in the Microsoft Store for Windows and on mobile phones to peacefully write your contents offline.

This is an unofficial Notion APIv3 library and website template. You can, for example, get notion pages as a RSS feed. You can also use it as a simple CMS (Content Management System).

Use Cases

Spawn a Website displaying the pages built with Notion in a few seconds. See below 'kubernetes'.

Get a RSS representation of all root pages of the main space.
This also transforms notion data to HTML:

    var rssFeed = await session.GetSyndicationFeed();

Get a RSS representation from the sub-pages of a page:

    var space = userContent.RecordMap.Space.First().Value;
    var firstPage = userContent.RecordMap.Block[space.Pages[0]];
    var subPages = firstPage.Content;

    var feedPublicBlog = await session.GetSyndicationFeed(subPages);
    feedPublicBlog.Title = new TextSyndicationContent(firstPage.Title);

Spawn a website displaying Notion pages in a few minutes

Setup your Notion pages and get your credentials

Create some content

Create a page at the root of Notion.so (the root page), then add subpages to this page with a title and an icon.
For each subpage, check "shared". Don't check "Shared" on the root page. Only shared pages will be displayed by our example, so you can prepare private pages in advance without publishing them.

When you encounter CmsPageTitle below in this setup, replace it with the exact title of your root page.

Documentation

• Using the notion's public api (Using the official API)
• Using the unofficial integration (legacy, using the unofficial API)

Sponsors

Big Thanks to those sponsors for supporting this project and keeping it free.

• vapolia.eu

notionsharp's Issues

Define a strategy to migrate to the official notion API

Define a strategy to migrate to the official notion API:

• keeping the unofficial API functional
• retaining most functionalities
• avoid duplicating existing codes.
• take the fastest and simplest path

Authentication can't be done in code. It only relies on a bearer token - an Authorize header transmitted with each request. Get a token using your notion account.

Path 1: TDD

Operation 1 - Create unit tests

• to get a specific root page given its name
• to get all blocks of a page, including all it's children pages, using pagination where necessary
• to process all blocks into html, using most of the existing code

Recreate a new block model if necessary.
In a new specific nuget.

Bonus:

• use a // pipeline (or reactivex) for ultra fast block to html transcoding

After op1 is finished, the API surface should be at least the same as the "old" nuget.

Operation 2 - Upgrade the blazor templates

• Use the new nuget from op1
• Simplify the authentication option model (use only the bearer token)
• publish changes

Bonus:

• add notion's data change detection (and trigger UI update)

Creating Pages and Documentation

Hi creators,

Is Creating pages available in the API? I haven't found any information in the code neither in the docs. Do you also provide some kind of extended documentation for the API?

Regards

License file missing?

Hi! just a quick note, but the NuGet package mentions that this library is under the MIT license but there's no license file in the repository!