**Note:** default Notion-Version used by NuGet package versions

**Note:** Default Notion-Version used by NuGet package versions

| Package version | Notion-Version |

| --- | --- |

| 4.0.0-preview-1.8.21.2022 | 2022年06月28日 |

| 4.4.0+ | 2022年06月28日 |

| 4.3.0+ | 2022年06月28日 |

| 4.0.0+ | 2022年06月28日 |

| 3.0.0+ | 2022年02月22日 |

| 2.0.0+ | 2021年08月16日 |

| 1.0.0+ | 2021年05月13日 |

Library also provides extension method to register NotionClient with Microsoft dependency injection.

The library provides an extension method to register NotionClient with Microsoft dependency injection.

services.AddNotionClient(options => {

options.AuthToken = "<Token>";

});

Then inject `INotionClient` into your services:

public class MyService

{

private readonly INotionClient _notionClient;

public MyService(INotionClient notionClient)

{

_notionClient = notionClient;

}

public async Task<Database> GetDatabaseAsync(string databaseId)

{

return await _notionClient.Databases.RetrieveAsync(databaseId);

}

}

After you initialized your client and got an id of a database, you can query it for any contained pages. You can add filters and sorts to your request. Here is a simple example:

- [x] Databases

- [x] **Authentication**

- [x] Create access token

- [x] Revoke access token

- [x] Introspect token (get token status and details)

- [x] Refresh access token

- [x] **Databases**

- [x] Retrieve a database

- [x] Query a database

- [x] Create a database

- [x] Update database

- [x] Retrieve a database

- [x] Pages

- [x] Update a database

- [x] **Pages**

- [x] Retrieve a page

- [x] Create a page

- [x] Update page

- [x] Update page properties

- [x] Retrieve page property item

- [x] Blocks

- [x] **Blocks**

- [x] Retrieve a block

- [x] Update a block

- [x] Retrieve block children

- [x] Append block children

- [x] Delete a block

- [x] Comments

- [x] **Comments**

- [x] Retrieve comments

- [x] Create comment

- [x] Users

- [x] Retrieve a User

- [x] **Users**

- [x] Retrieve a user

- [x] List all users

- [x] Retrieve your token's bot user

- [x] Search

- [x] Retrieve your token's bot user (me)

- [x] **Search**

- [x] Search across pages and databases

- [x] **File Uploads**

- [x] Create file upload

- [x] Send file upload

- [x] Complete file upload (for multi-part uploads)

- [x] List file uploads

- [x] Retrieve file upload

The library make use of `ILoggerFactory` interface exposed by `Microsoft.Extensions.Logging`. Which allow you to have ability to enable the internal logs when developing application to get additional information.

}

You can also refer `examples/list-users` example.

You can also refer to the `examples/list-users` example.

The SDK provides specific exception types for common API errors:

{

var page = await client.Pages.RetrieveAsync(pageId);

}

catch (NotionApiRateLimitException rateLimitEx)

{

Console.WriteLine($"Rate limited. Retry after: {rateLimitEx.RetryAfter}");

}

catch (NotionApiException apiEx)

{

Console.WriteLine($"API Error: {apiEx.NotionAPIErrorCode} - {apiEx.Message}");

}

The repository includes several example projects to help you get started:

- **[`examples/list-users`](examples/list-users/)** - Basic example showing how to list users and configure logging

- **[`examples/aspnet-core-app`](examples/aspnet-core-app/)** - ASP.NET Core integration example with dependency injection

- **[`examples/print-database-property-name-and-values`](examples/print-database-property-name-and-values/)** - Working with database properties

var newPage = await client.Pages.CreateAsync(new PagesCreateParameters

{

Parent = new DatabaseParentInput { DatabaseId = databaseId },

Properties = new Dictionary<string, PropertyValue>

{

{

"Title", new TitlePropertyValue

{

Title = new List<RichTextBase>

{

new RichTextText { Text = new Text { Content = "My New Page" } }

}

}

}

}

});

var appendResponse = await client.Blocks.AppendChildrenAsync(new BlockAppendChildrenRequest

{

BlockId = pageId,

Children = new List<ICreateBlock>

{

new ParagraphBlock

{

Paragraph = new ParagraphBlock.ParagraphData

{

RichText = new List<RichTextBase>

{

new RichTextText

{

Text = new Text { Content = "This is a new paragraph!" }

}

}

}

}

}

});

var fileUpload = await client.FileUploads.CreateAsync(new CreateFileUploadRequest

{

Name = "example.pdf",

FileType = FileType.Pdf,

FileSize = fileSize,

ExpiresTime = DateTime.UtcNow.AddHours(1)

});

var sendResponse = await client.FileUploads.SendAsync(new SendFileUploadRequest

{

FileUploadId = fileUpload.Id,

FileContent = fileBytes

});

This project exists thanks to all the people who contribute.

<Project Sdk="Microsoft.NET.Sdk">

<PropertyGroup>

<VersionPrefix>4.3.0-preview</VersionPrefix>

<VersionPrefix>4.4.0-preview</VersionPrefix>

<TargetFramework>netstandard2.0</TargetFramework>

<LangVersion>9.0</LangVersion>