Netzo

🇺🇸 EN

🇪🇸 ES

🇺🇸 EN

🇪🇸 ES

Appearance

On this page
netzo/apis/notion

Notion ​

Notion is an all-in-one workspace for your notes, tasks, wikis, and databases.

  • labels: project-management, collaboration, task-management, productivity
  • authentication: apiKey

Usage ​

ts
import { notion } from 'https://deno.land/x/netzo/apis/notion/mod.ts'

const { api } = notion({
  internalIntegrationToken: Deno.env.get('NOTION_INTERNAL_INTEGRATION_TOKEN'),
  notionVersion: Deno.env.get('NOTION_VERSION'),
})
import { notion } from 'https://deno.land/x/netzo/apis/notion/mod.ts'

const { api } = notion({
  internalIntegrationToken: Deno.env.get('NOTION_INTERNAL_INTEGRATION_TOKEN'),
  notionVersion: Deno.env.get('NOTION_VERSION'),
})

Configuration ​

The notion factory function expects an object with the following, and returns an object with an HTTP client api.

ParamTypeDefaultDescription
internalIntegrationTokenstringDeno.env.get('NOTION_INTERNAL_INTEGRATION_TOKEN')the API key to use for authentication
notionVersionstringDeno.env.get('NOTION_VERSION')Notion version

Refer to the API documentation to get the required information.

Examples ​

The following examples assume you have created an api client instance. Refer to the type definitions for all exported types to pass to the api client for typed responses.

Find pages ​

Find all the pages that belong to a specific database and match the query.

ts
import type { Pages, QueryDatabase } from 'netzo/apis/notion/types.ts'

const query: QueryDatabase = {}
const result = await api.databases[DATABASE_ID].query.post<Pages>(query)
const resultData = result.results
import type { Pages, QueryDatabase } from 'netzo/apis/notion/types.ts'

const query: QueryDatabase = {}
const result = await api.databases[DATABASE_ID].query.post<Pages>(query)
const resultData = result.results

Get page ​

Get a page by id.

Property ids can be passed as query parameters to limit the search to specific properties.

ts
import type { Page, QueryProperties } from 'netzo/apis/notion/types.ts'

const query: QueryProperties = {}
const resultData = await api.pages[PAGE_ID].get<Page>(query)
import type { Page, QueryProperties } from 'netzo/apis/notion/types.ts'

const query: QueryProperties = {}
const resultData = await api.pages[PAGE_ID].get<Page>(query)

Get page content ​

Get the content of a specific page.

ts
import type { Block, NotionPagination } from 'netzo/apis/notion/types.ts'

const query: NotionPagination = {}
const result = await api.blocks[PAGE_ID].children.get<Block>(query)
const resultData = result.results
import type { Block, NotionPagination } from 'netzo/apis/notion/types.ts'

const query: NotionPagination = {}
const result = await api.blocks[PAGE_ID].children.get<Block>(query)
const resultData = result.results

Find users ​

Find all users of the workplace.

ts
import type { NotionPagination, Users } from 'netzo/apis/notion/types.ts'

const query: NotionPagination = {}
const result = await api.users.get<Users>(query)
const resultData = result.results
import type { NotionPagination, Users } from 'netzo/apis/notion/types.ts'

const query: NotionPagination = {}
const result = await api.users.get<Users>(query)
const resultData = result.results

References ​

Copyright © 2023 Netzo