/notionr

Minimal client for Notion API (beta)

Primary LanguageRMIT LicenseMIT

Lifecycle: experimental R-CMD-check

notionr

Minimal client to access the Notion API (Beta).

Installation

Get the development version from github with:

# install.packages("devtools")
devtools::install_github("dmolitor/notionr")

⚠️ Warning ⚠️

The Notion API is under rapid development and this package isn't. It currently covers ~75% of the API functionality, but none of the PATCH or DELETE methods have been implemented. Additionally, since the API is in beta, some changes in its functionality may break existing functionality in this package. However, this should provide a solid base of functionality that can easily be extended and improved on.

Setup

  • notionr

    To start the OAuth flow to verify to Notion that you would like the notionr integration to have access to your workspace:

    notion_auth()
#> Waiting for authentication in browser...
#> Press Esc/Ctrl + C to abort
#> Authentication complete.
#> Access credentials have been stored at ~/.R/notionr/oauth/workspace-name/notionr_oauth_access.json

    Then, access the authorization token:

    key <- cached_access_code()
key
#> [1] "secret_eolsOUT1yhjncXdT0wLBz74i3MGDXAe6P**********"

  • Internal Integration

    Alternatively, if you want to create an internal integration, go to your integrations and create a new internal integration. From within the integration dashboard you can copy your authorization token and store it as desired.

  • Public Integration

    notionr is not yet set up to accomodate a public integration.